عنصر ربط الاشتراكات

يمكنك استخدام عنصر الربط /app/subscriptions في Graph API وإدارة منتج أحداث Webhooks للتطبيق. راجع وثائق /app/subscriptions لمعرفة العمليات التي يمكنك إجراؤها من خلال عنصر الربط هذا، وأي أذونات تحتاج إليها. يغطي هذا المستند فقط بعض العمليات المشتركة.

إنشاء الاشتراكات

للاشتراك في كائن وحقوله، أرسل طلب POST إلى عنصر الربط /app/subscriptions وقم بتضمين المعلمات التالية:

object - نوع الكائن الذي تريد إعداد اشتراكات الحقل له (على سبيل المثال، user).
callback_url - عنوان URL نقطة النهاية.
verify_token - سلسلة سيتم تضمينها كلما أرسلنا طلب التحقق.
fields - الحقول التي تريد الاشتراك فيها (على سبيل المثال، photos).

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

عينة من الطلب

curl -F "object=user" \ -F "callback_url=https://your-clever-domain-name.com/webhooks" \ -F "fields=photos" \ -F "verify_token=your-verify-token" \ -F "access_token=your-app-access-token" \ "https://graph.facebook.com/188559381496048/subscriptions"

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

إذا كانت الاستجابة ناجحة:

{
  "success": "true"
}

الحصول على معلومات الاشتراك

لعرض اشتراكات الكائنات والحقول التي قمت بإعدادها للتطبيق، أرسل طلب GET إلى عنصر الربط /app/subscriptions . على سبيل المثال، إذا كان معرف التطبيق 188559381496048، فيمكنك إجراء ما يلي:

عينة من الطلب

GET graph.facebook.com/188559381496048/subscriptions

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

{ "data": [ { "object": "user", "callback_url": "https://your-clever-domain-name.com/webhooks", "active": true, "fields": [ { "name": "photos", "version": "v2.10" }, { "name": "feed", "version": "v2.10" } ] } ] }