اكتشاف الأنشطة التجارية

يمكنك استخدام واجهة Instagram Graph API للحصول على بيانات التعريف الأساسية وأدوات القياس المتعلقة بحسابات Instagram للأعمال وحسابات منشئ المحتوى على Instagram.

التقييدات

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

نقاط النهاية

تتكون API من نقاط النهاية التالية. يمكنك الرجوع إلى الوثائق المرجعية لنقاط النهاية للحصول على المعلمات ومتطلبات الأذونات.

• GET /{ig-user-id}/business_discovery

الأمثلة

الحصول على عدد المتابعين والوسائط في الحساب

توضح عينة الاستعلام هذه كيفية الحصول على عدد المتابعين وعدد كائنات الوسائط التي تم نشرها في حساب Instagram للأعمال التابع لـ Blue Bottle Coffee. لاحظ أنه يتم تنفيذ استعلامات اكتشاف الأنشطة التجارية على معرف حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram (في هذه الحالة، يكون 17841405309211844)، وليس على اسم مستخدم حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram الذي تحاول الحصول على بيانات حوله (bluebottle في هذا المثال).

عينة من الطلب

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

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

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

الحصول على الوسائط

نظرًا لأنه يمكنك إجراء طلبات متداخلة من خلال تحديد عنصر ربط عبر المعلمة fields، يمكنك طلب عنصر الربط media التابع لحساب الأعمال أو حساب منشئ المحتوى المستهدف للحصول على جميع كائنات الوسائط المنشورة لديه:

عينة من الطلب

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

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

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

الحصول على أدوات القياس الأساسية حول الوسائط

يمكنك استخدام الطلبات المتداخلة وتوسيع الحقل للحصول على الحقول العامة لكائنات الوسائط في حساب الأعمال أو حساب منشئ المحتوى. لاحظ أن ذلك لا يمنحك الإذن للوصول إلى كائنات الوسائط مباشرةً، وسيفشل إجراء طلب GET على أي وسائط IG تم إرجاعها نظرًا لعدم توفير أذونات كافية.

على سبيل المثال، فيما يلي كيفية الحصول على عدد التعليقات وتسجيلات الإعجاب لكل كائن من كائنات الوسائط التي تم نشرها بواسطة Blue Bottle Coffee:

عينة من الطلب

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

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

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}