الصفحات

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

المطالبة بالصفحات

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

المطالبة بالصفحات كمالك

للمطالبة بصفحة لنشاطك التجاري باعتبارك OWNER، تحتاج إلى معرف الصفحة ومعرف النشاط التجاري. بعد ذلك، أرسل طلب POST:

يجب أن يتوفر لدى مقدم الطلب:

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

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

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

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

المطالبة بالصفحات كوكالة

للمطالبة بصفحة لنشاطك التجاري باعتبارك AGENCY، تحتاج إلى معرف الصفحة. بعد ذلك، أرسل طلب POST:

إذا كان مقدم الطلب لديه إذن المسؤول في الصفحة، فسيتم الموافقة على هذا الطلب تلقائيًا. إذا لم يكن كذلك، فسيحتاج مسؤول الصفحة إلى الموافقة على الطلب.

لا يمكن للوكالة إعادة مشاركة الصفحة مع نشاط تجاري آخر.

يمكن للوكالة بدء تشغيل الإعلانات على الصفحة (من خلال الحسابات الإعلانية التي لديهم صلاحية الوصول) على الفور.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

إذا كنت تستخدم AGENCY:

فيجب أن توفر permitted_tasks
فيجب أن يمتلك النشاط التجاري الصفحة
فيجب أن يحتوي رمز الوصول على الأذونات pages_manage_metadata وpages_show_list

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

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

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

عرض الصفحات المملوكة للنشاط التجاري أو الصفحات التي تنتمي إلى عملاء النشاط التجاري

لعرض جميع الصفحات التي يملكها نشاطك التجاري، استخدم استدعاء GET هذا:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

لعرض جميع الصفحات التي يمثلها نشاطك التجاري، استخدم استدعاء GET هذا:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

يرجع ذلك قائمة بالصفحات التي تخص عملاء مدير الأعمال.

إضافة صفحات مجمّعة

يمكنك إضافة صفحات منفردة إلى مدير أعمال باستخدام واجهة المستخدم في مدير الأعمال. لإضافة صفحات مجمّعة إلى مدير الأعمال، قم بإجراء استدعاء POST التالي:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

حيث:

<ACCESS_TOKEN> هو رمز وصول يتضمن الإذن business_management.
<BUSINESS_ID> هو معرف مدير الأعمال الذي يجب مطالبة الصفحات إليه.
<PAGE_ID_n> هي معرفات الصفحة التي يجب مطالبتها.

إزالة الصفحات

لإزالة صفحة من النشاط التجاري، قم بإجراء استدعاء DELETE هذا:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

إضافة أشخاص إلى الصفحات

بعد أن يصبح لدى نشاطك التجاري صفحة، يمكنك تعيين مهام الأشخاص فيها. تشمل المهام ما يلي:

الاسم	ثابت API	الوصف
المسؤول	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	يمكنه إدارة أدوار المسؤول وإرسال الرسائل والنشر باسم الصفحة وإنشاء الإعلانات وعرض التقارير.
المحرر	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	يمكنه تعديل الصفحة وإرسال الرسائل والنشر باسم الصفحة وإنشاء إعلانات وعرض التقارير.
المشرف	`['MODERATE', 'ADVERTISE', 'ANALYZE']`	يمكنه الرد على التعليقات وحذفها من الصفحة، وإرسال الرسائل باسم الصفحة، وإنشاء إعلانات، وعرض التقارير.
المُعلن	`['ADVERTISE', 'ANALYZE']`	يمكنه إنشاء إعلانات للصفحة وعرض الرؤى.
المحلل	`['ANALYZE']`	يمكن عرض التقارير.

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

page_id — معرف الصفحة
user_id — معرف المستخدم المطلوب إضافته
المهام المطلوب تعيينها

قم بإجراء هذا الاستدعاء POST لإضافة شخص ما مع المهام ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

يجب أن يكون معرف النشاط التجاري هو معرف النشاط التجاري الذي يملك الصفحة

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

تغيير وصول الصفحات

لتغيير مهام المستخدم الحالي، استخدم استدعاء POST نفسه الذي تستخدمه عند إضافة مستخدم جديد له مهام:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

عرض أذونات الصفحة

لعرض الصفحات التي تحتوي على أذونات المستخدم، قم بإجراء استدعاء GET هذا:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

لعرض أذونات محددة على صفحة، قم بإجراء استدعاء GET هذا:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

إزالة صلاحية الوصول إلى الصفحة

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

لإزالة صلاحية وصول شخص ما من صفحة تملكها، تحتاج

page_id — معرف الصفحة
user_id — معرف المستخدم المطلوب إزالته

يكون استدعاء DELETE كالتالي:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"