حسابات Meta المُدارة وعمليات دمج الجهات الخارجية

نظرة عامة

حسابات Meta المُدارة هي أحد أنواع الحسابات المتوفرة لأدوات الأعمال عبر Meta. يمكن للمؤسسات إدارة هذه الحسابات من خلال ميزات إدارية، بما في ذلك دعم تسجيل الدخول الموحد (SSO) وتوفير الحسابات تلقائيًا وغير ذلك الكثير. من خلال هذه الحسابات، يمكن للأفراد الوصول إلى أدوات الأعمال من Meta، مثل مدير الأعمال، باستخدام بيانات اعتماد العمل، من دون الحاجة إلى استخدام حساب فيسبوك الشخصي.

نظرًا إلى أنه من المفترض أن يتم استخدام حسابات Meta المُدارة لأغراض العمل فقط، فإن التقييدات التالية تنطبق على نوع حسابات Meta المُدارة:

• لا يحتوي على صفحة يوميات اجتماعية أو موجز أخبار فيسبوك
• لا يمكنه الوصول إلى المنتجات أو الأنظمة التي يتم عرضها للمستهلكون على facebook.com، باستثناء الوصول إلى المنشورات باسم الصفحة
• لا يمكنه الحصول على أذونات الأصول الشخصية (يجب أن يتم الحصول عليها من خلال حساب أعمال)
• لا يمكنه سوى منح الأذونات من نوع تطبيق الأعمال ولا يمكنه منح الأذونات المرتبطة بـ user_*، مثل user_friends أو user_posts. لاحظ أنه لا يزال بإمكان حسابات Meta المُدارة إكمال طلبات عمليات دفق تسجيل الدخول، ولكن سيتم تجاهل الأذونات المتعلقة بـ user_*.

حدث خطأ ما

لدينا مشكلة في تشغيل هذا الفيديو.

تعرف على المزيد

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

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

إذا كان تطبيقك يمكنه الوصول إلى أصول الأنشطة التجارية لدى العملاء باستخدام رموز وصول مستخدم النظام أو مشاركة الشركاء، فلا ينبغي أن يتأثر دمج الجهة الخارجية لديك. إذا كان تطبيقك يستخدم رموز وصول المستخدم (أو رمز وصول الصفحة الذي يتم إنشاؤه من رموز وصول المستخدم)، فإن أذونات تطبيقك وصلاحية الوصول إلى أصول النشاط التجاري الممنوحة بواسطة حسابات فيسبوك لن تنتقل تلقائيًا إلى حسابات Meta المُدارة الجديدة. سيتعين على المستخدمين إعادة منح الأذونات لأصول النشاط التجاري هذه باستخدام حسابات Meta المُدارة الجديدة للحفاظ على وصول التطبيقات إلى تلك الأصول.

إرشادات لموفري الخدمات الفنية

للحد من الانقطاعات المحتملة لاستدعاءات API بشكل استباقي، يوصى بأن يوفر تطبيقك ما يلي:

بدء الاختبار

إعداد بيئة اختبارية للتحقق من أن حسابات Meta المُدارة مدعومة بواسطة تكاملاتك.

اختبار حسابات Meta المُدارة

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

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

التقييدات

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

إنشاء حسابات العمل الاختبارية

يمكنك إنشاء حسابات اختبارية في لوحة معلومات التطبيق عن طريق الانتقال إلى قسم الحسابات الاختبارية في لوحة تحكم الأدوار > الحسابات الاختبارية، واختيار علامة التبويب حسابات Meta المُدارة والنقر على الزر إنشاء حساب اختباري. سيؤدي ذلك إلى فتح مربع حوار يسمح لك بإنشاء حساب اختباري.

يسمح لك مربع الحوار إنشاء حسابات اختبارية بما يلي:

• إنشاء حساب اختباري واحد.
• تحديد ما إذا كان سيتم تثبيت التطبيق افتراضيًا لكل حساب اختباري يتم إنشاؤه.
• تحديد إصدار Graph API المطلوب استخدامه في الاستدعاءات.
• منح الأذونات في التطبيق لكل حساب اختباري.

بمجرد إنشاء الحساب، ستظهر الحسابات الاختبارية في جدول حسابات Meta المُدارة.

الاختبار باستخدام حسابات Meta المُدارة

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

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

محاكاة الترحيل مع الحسابات الاختبارية

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

يجب استيفاء المتطلبات الأساسية التالية لاستخدام هذه الميزة:

بعد إكمال عملية النقل، ستتمكن من:

Webhooks

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

الميزات الرئيسية:

• إشعار قبل 30 يومًا: تنبهك الأداة قبل 30 يومًا عندما يبدأ المستخدم في ترحيل حسابات Meta المُدارة أو يمدد فترة الترحيل من جانبه.
• تنبيه انتهاء صلاحية الوصول: يخبرك على وجه التحديد بموعد فقدان الوصول نتيجة الترحيل.

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

الاشتراك

لاستلام الإشعارات، يجب الاشتراك في معلومات ترحيل حسابات Meta المُدارة لدى المستخدم. سوف نقوم بإنشاء حدث Webhook جديد للاشتراك فيه.

إذا كنت جديدًا على منتج Webhook، فيرجى اتباع دليل بدء استخدام أحداث Webhooks لإعداد تكوين حدث webhook، واختبار موضوعات أحداث webhooks التي تشترك فيها.

لإعداد أحداث Webhooks لحسابات Meta المُدارة، في لوحة معلومات التطبيق، انتقل إلى المنتجات > Webhooks، ثم حدد حساب Meta المُدار من القائمة المنسدلة، ثم انقر على اشتراك في هذا الكائن.

الإشعار

سنرسل إشعارات حدث Webhook كلما حدث تغيير في تاريخ انتهاء صلاحية ترحيل حسابات Meta المُدارة (عندما ينتهي الوضع الهجين للمستخدمين). سيحدث هذا أثناء إنشاء الترحيل وإذا طلب المستخدم تمديدًا للوضع الهجين وحصل على موافقة لتمديد الوضع الهجين.

مثال على إشعار حدث حساب Meta المُدار:

{
  "field": "migration_expire_time",
  "value": {
    "user_id": "4444444444",
    "migration_expire_time" => "2024-05-04T10:00:00Z"
  }
}

واجهات API الترحيل واستكشاف الأخطاء وإصلاحها

توفر واجهات API ترحيل حساب Meta المُدار ووثائق اكتشاف الأخطاء وحلها معلومات حول كيفية تحديد المستخدمين وحسابات الأعمال التي يتم ترحيلها وتاريخ انتهاء صلاحيتها وما إذا كان أي منها يمثل حساب Meta مُدارًا أم لا. is_work_account هو نوع نتيجة تمثل قيمة منطقية وتشير إلى ما إذا كان المستخدم يستخدم حساب Meta مُدارًا أم لا. تتوفر في كائن User. حقل user_access_expire_time هو طابع زمني يشير إلى موعد إلغاء وصول المستخدم إلى أصول معينة. بعد انتهاء تاريخ هذا الطابع الزمني، من المتوقع أن لا تتوفر لدى المستخدم صلاحية الوصول إلى الأصول بعد الآن. ستبدأ استدعاءات API اللاحقة التي تستخدم رمز وصول مستخدم فيسبوك الذي يحتاج إلى الوصول إلى هذه الأصول المحددة في إرجاع أخطاء الأذونات. يتوفر user_access_expire_time على الكائنات التالية:

• Business
• Page
• Ad Account
• Product Catalog
• Ads Pixel

التقييدات

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

الاستخدام الموصى به

• التحقق مما إذا كانت رموز الوصول المستلمة من العميل تنتمي إلى حساب Meta مُدار
• التحقق من موعد انتهاء صلاحية وصول المستخدم إلى أصول النشاط التجاري
• إرسال إشعارات أو تذكيرات إلى المستخدمين عندما تكون صلاحية الوصول إلى أصول معينة على وشك الانتهاء، ومطالبتهم بالتصريح باستخدام حساباتهم للاستمرار في استخدام الوظائف
• معالجة أخطاء API عن طريق اكتشاف صلاحيات الوصول منتهية الصلاحية وتوفير رسائل خطأ أو تعليمات مناسبة للمستخدمين للتواصل من خلال حساباتهم باستخدام صلاحية الوصول إلى أصول النشاط التجاري تلك

مثال على استدعاءات Graph API

1. استرداد حالة is_work_account

GET /<API_VERSION>/<USER_ID>?fields=is_work_account

{
  "id": "<USER_ID>",
  "name": "Romane Richter"
  "is_work_account": true
}

2. استرداد user_access_expire_time خلال نافذة مدتها 30 يومًا

GET /<API_VERSION>/<OBJECT_ID>?fields=user_access_expire_time&access_token=<ACCESS_TOKEN>

{
   "user_access_expire_time": "2023-06-23T12:00:00+00:00"
}

3. سيؤدي طلب الحقل قبل الترحيل إلى إرجاع بيانات فارغة

GET /<API_VERSION>/<OBJECT_ID>?fields=user_access_expire_time&access_token=<ACCESS_TOKEN>

{}

4. من المحتمل أن تؤدي الطلبات التي يتم تقديمها بعد 30 يومًا من الترحيل (بعد انتهاء user_access_expire_time) إلى ظهور أخطاء

GET /<API_VERSION>/<OBJECT_ID>?fields=user_access_expire_time&access_token=<ACCESS_TOKEN>

{
  "error": {
    "message": "(#100) Object does not exist, cannot be loaded due to missing permission or reviewable feature, or does not support this operation. This endpoint requires the 'pages_read_engagement' permission or the 'Page Public Content Access' feature or the 'Page Public Metadata Access' feature. Refer to https://developers.facebook.com/docs/apps/review/login-permissions#manage-pages, https://developers.facebook.com/docs/apps/review/feature#reference-PAGES_ACCESS and https://developers.facebook.com/docs/apps/review/feature#page-public-metadata-access for details.",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "AZdHiJUBflrZnE-RNKrHAah"
  }
}

الأذونات والأخطاء

راجع أيضًا

تفضل بزيارة الأسئلة المتكررة حول عمليات دمج موفري الخدمات الفنية.