‏منصة Instagram‏

بدء الاستخدام

يوضِّح هذا المستند كيفية استدعاء واجهة Instagram Graph API بنجاح باستخدام تطبيقك والحصول على كائنات وسائط لحساب منشئ محتوى Instagram أو حساب Instagram للأعمال. ويفترض أنك على دراية بواجهة Graph API وتسجيل دخول فيسبوك وطريقة تنفيذ عمليات استدعاء واجهة REST API. إذا لم يكن لديك تطبيق حتى الآن، فيمكنك استخدام مستكشف Graph API بدلاً من ذلك وتخطي الخطوتين 1 و2.

قبل البدء

ستحتاج إلى الوصول إلى ما يلي:

1. تكوين تسجيل دخول فيسبوك

أضف منتج تسجيل دخول فيسبوك إلى تطبيقك في لوحة معلومات التطبيق.

يمكنك ترك كل الإعدادات على الوضع الافتراضي. إذا كنت تقوم بتنفيذ تسجيل دخول فيسبوك يدويًا (الأمر الذي لا نوصيك به)، فأدخل redirect_uri في الحقل محددات URI صالحة لإعادة توجيه OAuth. وإذا كنت ستستخدم إحدى مجموعات SDK التي نوفرها، فيمكنك ترك الحقل فارغًا.

2. تنفيذ تسجيل دخول فيسبوك

يمكنك متابعة وثائق تسجيل دخول فيسبوك التي نوفرها للمنصة لديك، وتنفيذ تسجيل دخول فيسبوك في تطبيقك. قم بإعداد عملية التنفيذ الخاصة بك لطلب الأذونات التالية:

3. الحصول على رمز وصول مستخدم

بمجرد تنفيذ تسجيل دخول فيسبوك، تأكد من أنك سجّلت الدخول إلى حساب المطوّر على فيسبوك، ثم قم بالوصول إلى تطبيقك وتشغيل نموذج تسجيل دخول فيسبوك المشروط. وتذكّر أنه يجب أن يكون حساب المطوّر على فيسبوك قادرًا على تنفيذ المهام على صفحة فيسبوك المرتبطة بحساب Instagram الذي تريد الاستعلام عنه.

بمجرد تشغيل تسجيل الدخول المشروط، انقر على موافق لمنح تطبيقك الأذنين instagram_basic وpages_show_list.

يجب أن تقوم API بإرجاع رمز وصول مستخدم. احفظ الرمز المميز بحيث يمكن لتطبيقك استخدامه في بعض الاستعلامات التالية. وإذا كنت تستخدم مستكشف Graph API، فسيتم حفظه تلقائيًا وعرضه في الحقل رمز الوصول من أجل الرجوع إليه:

4. الحصول على صفحات المستخدم

استعلم عن نقطة النهاية GET /me/accounts (تتحول هذه إلى GET /{user-id}/accounts بحيث تعمل على تنفيذ طلب GET في عقدة مستخدم فيسبوك بناءً على رمز الوصول المتوفر لديك).

curl -i -X GET \
 "https://graph.facebook.com/v19.0/me/accounts?access_token={access-token}"

يجب أن يؤدي ذلك إلى إرجاع مجموعة من صفحات فيسبوك بحيث يمكن لمستخدم فيسبوك الحالي تنفيذ المهام MANAGE أو CREATE_CONTENT أو MODERATE أو ADVERTISE بها:

{
  "data": [
    {
      "access_token": "EAAJjmJ...",
      "category": "App Page",
      "category_list": [
        {
          "id": "2301",
          "name": "App Page"
        }
      ],
      "name": "Metricsaurus",
      "id": "134895793791914",  // capture the Page ID
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT",
        "MANAGE"
      ]
    }
  ]
}

احصل على معرف صفحة Facebook المرتبط بحساب Instagram الذي تريد الاستعلام عنه. وتذكّر أنه يمكن لمستخدمي تطبيقك تنفيذ مهام بصفحات متعددة، لذلك سيتعين عليك في نهاية الأمر تقديم منطق يمكنه تحديد معرف الصفحة الصحيح المطلوب الحصول عليه (أو تصميم واجهة مستخدم حيث يمكن لمستخدمي تطبيقك تحديد الصفحة الصحيحة نيابة عنك).

5. الحصول على حساب Instagram للأعمال المرتبط بالصفحة

استخدم معرف الصفحة الذي سجلته للاستعلام عن نقطة النهاية GET /{page-id}?fields=instagram_business_account:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/134895793791914?fields=instagram_business_account&access_token={access-token}"

يجب أن يُرجع هذا مستخدم IG — حساب منشئ محتوى Instagram أو حساب Instagram للأعمال — مرتبط بصفحة فيسبوك.

{
  "instagram_business_account": {
    "id": "17841405822304914"  // Connected IG User ID
  },
  "id": "134895793791914"  // Facebook Page ID
}

سجل معرف مستخدم IG.

6. الحصول على كائنات وسائط حساب Instagram للأعمال

استخدم معرف مستخدم IG الذي سجلته للاستعلام عن نقطة النهاية GET /{ig-user-id}/media:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17841405822304914/media?access_token={access-token}"

يجب أن يُرجع هذا المعرفات المرتبطة بكل كائنات وسائط IG لدى مستخدم IG:

{
  "data": [
    {
      "id": "17918195224117851"
    },
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUkdGRXA2eHNNTUs4T1ZAXNGFxQTAtd3U4QjBLd1B2NXRMM1NkcnhqRFdBcEUzSDVJZATFoLWtXMWZAGU2VrRTk2RHVtTVlDckI2NjN0UERFa2JrUk4yMW13",
      "after": "QVFIUmlwbnFsM3N2cV9lZAFdCa0hDeV9qMVliT0VuMmJyNENxZA180c0t6VjFQVEJaTE9XV085aU92OUFLNFB6Szd2amo5aV9rTlVBcnNlWmEtMzYxcE1HSFR3"
    }
  }
}

إذا كان بإمكانك تنفيذ هذا الاستعلام النهائي بنجاح، فيجب أن تكون قادرًا على إجراء الاستعلامات باستخدام أي من نقاط نهاية واجهة Instagram Graph API — وما عليك سوى الرجوع إلى الدلائل والمراجع المتنوعة التي نوفرها لمعرفة ما يمكن أن تفعله كل نقطة نهاية ونوع الأذونات التي تطلبها.

الخطوات التالية

  • قم بتطوير تطبيقك بشكل أكبر حتى يتمكن من استخدام أي نقاط نهاية أخرى يحتاجها بنجاح، وتتبع الأذونات التي تتطلبها كل نقطة نهاية
  • أكمل عملية مراجعة التطبيقات واطلب اعتماد كل الأذونات التي سيحتاج إليها تطبيقك بحيث يمكن لمستخدمي التطبيق منحها بينما يكون تطبيقك في وضع النشر
  • تبديل تطبيقك إلى وضع البث النشر وتسويقه للمستخدمين المحتملين

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