الإشارات

تمثل مجموعة من كائنات وسائط IG التي تمت فيها الإشارة إلى مستخدم IG بواسطة مستخدم Instagram آخر.

الإنشاء

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

القراءة

GET /{ig-user-id}/tags

يمكن إرجاع قائمة بكائنات وسائط IG التي تمت الإشارة إلى مستخدم IG فيها بواسطة مستخدم Instagram آخر.

التقييدات

لن يتم إرجاع كائنات وسائط IG الخاصة.

المتطلبات

النوع	الوصف
رموز الوصول	المستخدم
الميزات	غير متوفر.
الأذونات	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` إذا تم الحصول على الرمز من مستخدم تم منح دوره بالصفحة عبر مدير الأعمال، فيلزم أيضًا توفير أحد الأذونات التالية: `ads_management` أو `business_management` أو `pages_read_engagement`.
المهام	يجب أن يكون مستخدم التطبيق قادرًا على تنفيذ مهام مناسبة في الصفحة بناءً على الأذونات التي يطلبها التطبيق.

بنية الطلب

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

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

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

المفتاح	القيمة
`access_token` مطلوبة String (سلسلة)	يمثل رمز وصول مستخدم Instagram لدى مستخدم التطبيق.
`fields` قائمة مفصولة بفاصلة	يمثل قائمة مفصولة بفاصلة تضم الحقول وعناصر الربط التي تريد تضمينها في الاستجابة. وإذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

الحقول

يمكنك استخدام معلمة سلسلة الاستعلام fields لتحديد الحقول التي تريد تضمينها في أحد كائنات وسائط IG التي يتم إرجاعها.

استدعاءات الإصدار 10.0 والإصدارات الأقدم حتى 7 سبتمبر 2021: سيعمل الحقل like_count في وسائط IG على إرجاع القيمة 0 إذا كان مالك الوسائط لديه أعداد إعجاب مخفية عليها.

استدعاءات الإصدار 11.0 والإصدارات الأحدث، وكل الإصدارات في 7 سبتمبر 2021: إذا تم الاستعلام بشكل غير مباشر عن وسائط IG عبر نقطة نهاية أخرى أو توسيع الحقل، فسيتم حذف الحقل like_count من استجابات واجهة API إذا كان مالك الوسائط لديه أعداد تسجيلات إعجاب مخفية عليها. وسيعمل الاستعلام بشكل مباشر عن وسائط IG (والتي يمكن إجراؤها فقط من خلال مالك وسائط IG) على إرجاع عدد تسجيلات الإعجاب الفعلي، حتى إذا كانت أعداد تسجيلات الإعجاب مخفية.

عناصر الربط

يمكنك استخدام معلمة سلسلة الاستعلام fields لتحديد عناصر الربط التي تريد تضمينها في أحد كائنات وسائط IG التي يتم إرجاعها.

الاستجابة

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

{
  "{field}":"{value}",
  ...
}

تقسيم الصفحات

يدعم عنصر الربط هذا ميزة تقسيم الصفحات القائم على المؤشر، لذا ستتضمن الاستجابة المؤشرين before وafter إذا كانت الاستجابة تحتوي على صفحات متعددة من البيانات. وعلى عكس تقسيم الصفحات القياسي القائم على المؤشر، لن تتضمن الاستجابة الحقل previous أو next، لذلك سيتعين عليك استخدام المؤشرين before وafter لإنشاء سلسلتي الاستعلام previous وnext يدويًا حتى تتمكّن من تصفح مجموعة البيانات التي تم إرجاعها.

عينة من الطلب

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

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

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

التحديث

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

الحذف

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