نظرة عامة على إدارة الأصل

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

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

مجموعات أصول النشاط التجاري

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

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

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

مع API هذه، يمكنك إدارة مجموعات أصول النشاط التجاري التي أنشأها شخص بالفعل عبر مدير الأعمال أو يمكنك إدارة الأصول ضمن مجموعة أصول النشاط التجاري. يمكنك إجراء ما يلي:

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

الأذونات

لاستخدام API مجموعات أصول النشاط التجاري، يحتاج التطبيق إلى مستوى وصول API التسويق المناسب:

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

تحتاج إلى أذونات إضافية لـ:

نقاط نهاية مجموعة أصول النشاط التجاري	الأذونات المطلوبة
الحصول على قائمة الحسابات الإعلانية	`ads_management`
الحصول على قائمة كتالوجات المنتجات أو إضافة كتالوج منتجات أو إزالة كتالوج منتجات	`ads_management`
الحصول على حسابات Instagram أو إضافة حساب Instagram أو إزالة حساب Instagram	.`ads_management`. إذا كنت تستخدم الإصدار 4.0 من API التسويق، فستحتاج أيضًا إلى `instagram_basic`.
الحصول على أحداث البيكسل	`ads_read`
الحصول على قائمة مجموعات الأحداث بلا اتصال	`ads_management`
الحصول على قائمة التحويل المخصص	`ads_read`
إضافة تحويل مخصص	`ads_management`

التقييدات

ستشاهد خطأً إذا حاولت تقليل الأذونات الخاصة بأصل موجود في مجموعة أصول النشاط التجاري أو إزالتها عبر استدعاءات API التالية:

طلب DELETE إلى /{page_id}/assigned_users
طلب POST إلى /{page_id}/assigned_users
طلب DELETE إلى /act_{ad_account_id}/assigned_users
طلب POST إلى /act_{ad_account_id}/assigned_users

لتقليل الأذونات أو إزالتها، اتبع هذه الخطوات:

يمكنك إجراء استدعاء للحصول على قائمة بمجموعات الأصول المرتبطة بالنشاط التجاري. ابحث عن مجموعات الأصول حيث يساوي contained_asset_id القيمة {page_id} أو {ad_account_id}.
بالنسبة لكل معرف مجموعة أصول النشاط التجاري يتم إرجاعه، يمكنك إجراء استدعاء API لإزالة مستخدم من تلك المجموعة.
بعد ذلك، يمكنك استدعاء طلب DELETE أو POST أعلاه لإزالة الإذن لذلك المستخدم في الصفحة أو الحساب الإعلاني.

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

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

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

يمكنك إضافة أذونات المستخدم على مستوى الأصول باستخدام API الأصول، مثل تغيير حالة الشخص من مشرف الصفحة إلى مسؤول. راجع الأمثلة على الصفحة والحساب الإعلاني.

استبدلت مجموعات أصول النشاط التجاري API المشروعات في 13 أكتوبر 2019. يجب ترحيل كل التطبيقات في API المشروعات لمجموعات أصول النشاط التجاري.

الأدوار المسموح بها

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

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

الكتالوجات

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

ثابت API	الاسم	الوصف
`['MANAGE', 'ADVERTISE']`	مسؤول الكتالوج	بإمكانه إدارة كل ما يتعلق بالكتالوج من خلال صلاحية الوصول الكامل للقراءة والكتابة، بما في ذلك إنشاء/تحديث/حذف العناصر وإدارة المواجز وإرفاق الكتالوج إلى أحداث البيكسل والتطبيقات وإنشاء مجموعات المنتجات وتشغيل إعلانات كتالوج Advantage+ مع الكتالوج وتغيير إعدادات الكتالوج وما إلى ذلك.
`['ADVERTISE']`	معلن الكتالوج	بإمكانه إنشاء مجموعات المنتجات وتشغيل إعلانات كتالوج Advantage+ مع الكتالوج. لا يمكنه تعديل المنتجات أو المواجز أو إعدادات الكتالوج.

الحسابات الإعلانية

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

ثابت API	الاسم	الوصف
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	مسؤول الحساب الإعلاني	بإمكانه إدارة كل ما يتعلق بالحملات الإعلانية وإعداد التقارير والفوترة وأذونات الحساب ويمكنه تعيين حدود إنفاق الحملة الإعلانية. بإمكان مسؤولي الحساب الإعلاني أيضًا ربط طرق دفع النشاط التجاري.
`['ADVERTISE', 'ANALYZE']`	المعلن في الحساب الإعلاني	بإمكانه عرض الإعلانات وتعديلها وإعداد الإعلانات باستخدام طريقة الدفع المرتبطة بالحساب الإعلاني.
`['ANALYZE']`	محلل الحساب الإعلاني	بإمكانه عرض أداء الإعلان.

الصفحات

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

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

التطبيقات

لا توجد واجهات API لإدارة الأدوار أو المهام للتطبيقات في مدير الأعمال.

حسابات Instagram

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