إنشاء مستخدم النظام واسترداده وتحديثه

الإنشاء

استخدم رمز مستخدم النظام المسؤول أو رمز وصول المستخدم المسؤول لإنشاء مستخدم نظام.

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

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

إنشاء مستخدم النظام المسؤول وإنشاء رمز

1. قم بإنشاء مستخدم نظام مسؤول باستخدام رمز وصول المستخدم المسؤول لديك.
2. يمكنك تثبيت التطبيق من خلال مستخدم النظام المسؤول باستخدام رمز الوصول الخاص بالمستخدم المسؤول.
3. يمكنك إنشاء رمز مستخدم النظام المسؤول باستخدام رمز الوصول للمستخدم المسؤول.

إنشاء مستخدم النظام

1. يمكنك إنشاء مستخدم نظام باستخدام رمز الوصول الخاص بالمستخدم المسؤول.
2. أو قم بإنشاء مستخدم نظام باستخدام رمز الوصول الخاص بمستخدم النظام المسؤول في حساب مدير الأعمال، إذا قمت بإنشاء واحد.

إنشاء رمز الوصول لمستخدم النظام

1. يمكنك تثبيت التطبيق من خلال مستخدم النظام باستخدام رمز الوصول من: المستخدم المسؤول أو مستخدم النظام المسؤول، أو مستخدم نظام آخر.
2. يمكنك تعيين الإذن للأصول (مثل الحسابات الإعلانية والصفحات) التي تنتمي إلى حساب مدير الأعمال لديك. يجب تعيين الأذونات لمستخدم النظام الذي تم إنشاؤه حديثًا باستخدام رمز الوصول من: المستخدم المسؤول أو مستخدم النظام المسؤول.
3. يمكنك إنشاء رمز وصول مستخدم النظام باستخدام رمز الوصول للمستخدم المسؤول أو مستخدم النظام المسؤول.
4. الآن، استخدم رمز وصول مستخدم النظام لتنفيذ استدعاءات API في أصول النشاط التجاري.

لإنشاء مستخدم نظام أو مستخدم نظام مسؤول عبر API، تحتاج إلى:

• رمز وصول: خاص بمستخدم مسؤول أو مستخدم نظام مسؤول في حساب مدير الأعمال هذا
• الدور: ADMIN أو EMPLOYEE
• الاسم: معرف مستخدم النظام هذا أو مستخدم النظام المسؤول

لإنشاء مستخدم نظام، أرسل طلب POST:

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

يُرجع ذلك id على مستوى التطبيق لمستخدم النظام الجديد:

{
  "id" : "100000008899900"
}

هذا هو المعرف على مستوى التطبيق لمستخدم النظام. يجب استخدام هذا المعرف لتنفيذ استدعاءات API، وليس المعرف المتعارف عليه في Business Manager > System Users.

الاسترداد

للحصول على قائمة بمستخدمي النظام، تحتاج إلى رمز وصول المستخدم المسؤول أو مستخدم النظام المسؤول. تتضمن القائمة مستخدمي النظام المسؤولين، والمعرفات على مستوى التطبيق.

أرسل طلب GET:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

يؤدي ذلك إلى إرجاع قائمة بجميع مستخدمي النظام، بما في ذلك مستخدمي النظام المسؤولين، المملوكين بواسطة مدير الأعمال:

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

التحديث

يمكنك تغيير اسم مستخدم النظام أو مستخدم النظام المسؤول:

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

إلغاء رموز الوصول

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

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

تُرجع الاستجابة true، إذا كان الاستدعاء ناجحًا. بعد ذلك، يمكنك إنشاء رموز وصول جديدة لمستخدم النظام، كما هو موضح أعلاه.