نظرة عامة

واجهة Instagram Graph API هي مجموعة من نقاط نهاية واجهة Graph API في فيسبوك والتي تسمح للتطبيقات بالوصول إلى البيانات في حسابات Instagram الاحترافية (حسابات الأعمال ومنشئي المحتوى). إذا لم تكن على دراية بـ Graph API في فيسبوك، فيُرجى قراءة وثائق Graph API قبل المتابعة.

عنوان URL الأساسي

يمكن الوصول إلى كل نقاط النهاية عبر المضيف graph.facebook.com.

مستخدمو التطبيق

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

تنطبق هذه المتطلبات على كل مستخدمي التطبيق، حتى على هؤلاء الذين يتمتعون بدور في تطبيقك أو بدور في نشاط تجاري قام بمطالبة تطبيقك.

المصادقة

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

التصريح

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

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

يمكنك طلب الأذونات من مستخدمي التطبيق من خلال تنفيذ تسجيل دخول فيسبوك. يمكن لمستخدمي التطبيق الذين لديهم دور في تطبيقك منح أي أذونات مطلوبة. ولا يمكن لمستخدمي التطبيق الذين لا يتمتعون بدور في تطبيقك إلا منح الأذونات والميزات التي تم اعتمادها من خلال عملية مراجعة التطبيقات.

تستخدم واجهة API الأذونات والميزات التالية:

يمكنك الرجوع إلى مرجع نقطة النهاية لتحديد الإذن والميزات التي سيحتاج تطبيقك إلى طلبها من مستخدمي التطبيق.

المراسلة في Instagram

إذا كنت تخطط لتنفيذ المراسلة في Instagram من منصة Messenger، فستحتاج إلى تضمين الإذن instagram_manage_messages. تعرف على المزيد حول المراسلة في Instagram.

المساهمون

تتيح ميزة Instagram Collab لمستخدمي تطبيق Instagram المشاركة في تأليف المحتوى (أي نشر الوسائط) مع حسابات أخرى (المساهمون).

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

الصفحات

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

تتناول مقالة المساعدة التي نوفرها بعنوان إضافة صفحة فيسبوك المتصلة بحساب Instagram احترافي وتغييرها كيفية ربط صفحة فيسبوك بحساب Instagram احترافي.

المهام

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

إذن	`MANAGE`	`CREATE_CONTENT`	`MODERATE`	`ADVERTISE`	`ANALYZE`
instagram_basic	✔	✔	✔	✔	✔
instagram_content_publish	✔	✔
instagram_manage_comments	✔	✔	✔
instagram_manage_insights	✔	✔	✔	✔	✔

يمكنك تحديد المهام التي يمكن لمستخدم التطبيق إجرائها على الصفحة من خلال الاستعلام عن نقطة النهاية GET /me/accounts برمز وصول المستخدم الخاص بمستخدم التطبيق. ستقوم نقطة النهاية بإرجاع قائمة بالصفحات التي يمكن لمستخدم التطبيق إجراء مهام فيها، وستحدد المهام التي يمكن للمستخدم إجرائها في كل صفحة.

يمكنك الرجوع إلى وثائق المرجع للاطلاع على الأذونات التي تتطلبها نقطة النهاية. ولا تدعم واجهة API مستخدمي نظام مدير الأعمال أو مستخدمي التطبيق الذين يتمتعون بدور المساهم في البث المباشر.

الإشارة إلى المهام

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

الصفحات الكلاسيكية

تشير الصفحات الكلاسيكية إلى المهام كأدوار. ويمكن لمستخدمي التطبيق الذين يتمتعون بدور المسؤول على صفحة ما منح تطبيقك أي إذن. ويمكن لمستخدمي التطبيق الذين يتمتعون بأدوار أخرى منح الأذونات كما يلي:

الدور	الأذونات الممنوحة
المحرر	instagram_basic instagram_content_publish
المشرف	instagram_basic instagram_manage_comments instagram_manage_insights
المعلن	instagram_basic instagram_manage_insights
المحلل	instagram_basic instagram_manage_insights

صفحات التجربة الجديدة

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

وصول المهمة	الأذونات الممنوحة
الإعلانات	instagram_basic
المحتوى	instagram_basic instagram_content_publish
الرؤى	instagram_basic instagram_manage_insights
نشاط الرسائل والمجتمع	instagram_basic instagram_manage_comments

لتحديد إذا ما كانت الصفحة تستخدم التجربة الجديدة، اطلب الحقل has_transitioned_to_new_page_experience الخاص بها. تُرجع هذه القيمة true إذا كانت الصفحة تستخدم التجربة الجديدة.

مراجعة التطبيقات

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

لا يجب أن تتضمن عملية تقديم التطبيق لإجراء مراجعة التطبيقات أي بيانات اعتماد لحساب اختباري على Facebook إذا قمت بتنفيذ تسجيل دخول فيسبوك وكان تطبيقك متوفرًا للعامة. ومع ذلك، إذا كان مراجعونا بحاجة إلى تسجيل الدخول إلى حساب غير حساب Facebook لتشغيل تنفيذ تسجيل دخول فيسبوك، يجب عليك تضمين بيانات اعتماد حساب غير حساب Facebook في عملية تقديم التطبيق.

التطبيقات الخاصة

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

التحقق من النشاط التجاري

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

تقييد معدلات الاستدعاء

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

Webhooks

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

المراسلة في Instagram

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