‏منصة Instagram‏

الهاشتاج في Instagram (IG)

تمثل الهاشتاج في Instagram.

القيود

  • متوفر فقط لتسجيل دخول فيسبوك للأعمال.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /<IG_HASHTAG_ID>

يتم إرجاع الحقول وعناصر الربط المرتبطة بالهاشتاج في IG.

القيود

يمكنك الاستعلام عن 30 إشارة هاشتاج فريدة كحد أقصى في غضون 7 أيام.

المتطلبات

النوعالوصف

الميزات

Instagram Public Content Access

الأذونات

instagram_basic


إذا تم الحصول على الرمز من مستخدم تم منح دوره بالصفحة عبر "مدير الأعمال"، فيلزم أيضًا توفير أحد الأذونات التالية: ads_management أو business_management أو pages_read_engagement.

الرموز المميزة

رمز وصول المستخدم الخاص بمستخدم التطبيق.

بنية الطلب

GET https://graph.facebook.com/<IG_HASHTAG_ID>
  ?fields={fields}
  &access_token={access-token}

معلمات سلسلة الاستعلام

يمكن تضمين معلمات سلسلة الاستعلام التالية لتعزيز الطلب.

المفتاحالقيمة

access_token
مطلوبة
String (سلسلة)

رمز وصول مستخدم Instagram الخاص بمستخدم التطبيق.

fields
قائمة مفصولة بفاصلة

قائمة مفصولة بفاصلة تتضمن الحقول وعناصر الربط التي ترغب في إرجاعها. إذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

الحقول

يمكنك استخدام معلمة سلسلة الاستعلام fields لطلب الحصول على الحقول التالية المرتبطة بالهاشتاج في IG.

اسم الحقلالوصف

id

معرف الهاشتاج (يتم تضمينه افتراضيًا). علمًا بأن المعرفات تكون ثابتة وعامة.

name

اسم الهاشتاج من دون رمز التجزئة في البداية.

عناصر الربط

يمكنك طلب عناصر الربط التالية كمعلمات المسار أو من خلال استخدام معلمة سلسلة الاستعلام fields.

عنصر الربطالوصف

recent_media

احصل على قائمة بأحدث كائنات وسائط IG للصور ومقاطع الفيديو التي يتم نشرها بهاشتاج محدد.

top_media

يمكن إرجاع كائنات وسائط IG الأكثر رواجًا للصور ومقاطع الفيديو من خلال إشارة الهاشتاج.

الاستجابة

كائن بتنسيق لغة JSON يتضمن الحقول الافتراضية والمطلوبة.

{
  "<FIELD_NAME>":"<FIELD_VALUE",
  ...
}

عينة من الطلب

GET https://graph.facebook.com/17841593698074073
  ?fields=id,name
  &access_token=EAADd...

عينة من الاستجابة

{
  "id": "17841593698074073",
  "name": "coke"
}

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.