استكشاف الأنشطة التجارية لمستخدم IG

يمكنك الحصول على بيانات حول مستخدمي IG الآخرين في حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram.

الإنشاء

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

القراءة

GET /{ig-user-id}?fields=business_discovery.username({username})

يمكن إرجاع بيانات حول مستخدم IG آخر في حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram. ويمكنك إجراء هذا الطلب بشأن مستخدم IG في حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram الذي يجري الاستعلام، وكذلك تحديد النشاط التجاري المستهدف باستخدام المعلمة username.

التقييدات

لن يتم إرجاع بيانات حول مستخدمي IG في حسابات Instagram للأعمال المُقيدة بفئة عمرية معينة.

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

• {username} (مطلوب) — يمثل اسم المستخدم الخاص بمستخدم IG في حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram والذي تريد الحصول على بيانات متعلقة به.

الأذونات

رمز وصول مستخدم فيسبوك الذي يتضمن الأذونات التالية:

• instagram_basic
• instagram_manage_insights
• pages_read_engagement أو pages_show_list

توسيع الحقل

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

عينة من الطلب باستخدام توسيع الحقل

يمكن الحصول على بيانات حول شركة "Blue Bottle Coffee" لدى مستخدم IG في حساب Instagram للأعمال، واستخدام توسيع الحقل لطلب معرفة أعداد المتابعين والوسائط لديه.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

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

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

الوصول إلى عناصر الربط باستخدام توسيع الحقل

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

عينة من الطلب باستخدام عنصر الربط

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

عينة من الاستجابة باستخدام عنصر الربط

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

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

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

عينة من الطلب

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

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

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

التحديث

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

الحذف

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