‏‎Business Management APIs‎‏

المرجع

المنشور

نقطة النهاية	الوصف
`/{ad-account-id}/ads`	إنشاء إعلان.
`/{agreement-request-id}`	الموافقة على طلب اتفاقية النشاط التجاري المعلق أو رفضه.
`/{business-creative-folder-id}`	إنشاء مجلد عناصر تصميمات النشاط التجاري وحدّثه.
`/{business-id}/creative_folders`	توفير مجلد عناصر تصميمات النشاط التجاري.
`/{business-id}/images`	تحميل الصور إلى مجلد عناصر التصميمات.
`/{business-id}/videos`	تحميل مقاطع الفيديو إلى مجلد عناصر التصميمات.
`/{business-creative-folder-id}/agencies`	إضافة شريك ما إلى مجلد عناصر التصميمات.
`/{business-creative-folder-id}/assigned_users`	الحصول على قائمة بالأشخاص الذين لديهم صلاحية الوصول إلى مجلد عناصر تصميمات النشاط التجاري.

القراءة

نقطة النهاية	الوصف
`/{business-creative-folder-id}`	الحصول على تفاصيل حول مجلد عناصر تصميمات النشاط التجاري.
`/{business-id}/creative_folders`	الحصول على قائمة بمجلدات عناصر تصميمات النشاط التجاري التي يمكن للنشاط التجاري الوصول إليها.
`/{business-id}/creatives`	الحصول على صور النشاط التجاري ومقاطع فيديو النشاط التجاري للنشاط التجاري.
`/{business-id}/initiated_sharing_agreement`	الحصول على قائمة بطلبات الاتفاقيات المعلقة. تمت إعادة تقديم نقطة النهاية هذه في مايو 2020. سابقًا، تم إيقاف استخدام `/initiated_sharing_agreement` عند طرح Graph API بالإصدار 6.0.
`/{business-image-id}`	الحصول على تفاصيل الصورة.
`/{business-image-id}/insights`	الحصول على رؤى الصورة المشتركة.
`/{business-video-id}`	الحصول على تفاصيل الفيديو المشترك.
`/{business-video-id}/insights`	الحصول على رؤى الفيديو المشترك.
`/{business-creative-folder-id}/agencies`	الحصول على قائمة بالأنشطة التجارية التي لديها صلاحية الوصول إلى مجلد عناصر التصميمات.
`/{business-creative-folder-id}/assigned_users`	الحصول على قائمة بالأشخاص الذين لديهم صلاحية الوصول إلى مجلد عناصر التصميمات.

الحذف

نقطة النهاية	الوصف
`/{business-creative-folder-id}`	حذف مجلد عناصر التصميمات.
`/{business-creative-folder-id}/agencies`	إزالة شريك من مجلد عناصر التصميمات.
`/{business-creative-folder-id}/assigned_users`	إزالة مستخدم من مجلد عناصر التصميمات.
`/{business-image-id}`	إزالة صورة مشتركة.
`/{business-video-id}`	إزالة فيديو مشترك.

المهام المسموح بها

المهمة المسموح بها لمستخدم النشاط التجاري	الوصف
`CREATE_CONTENT`	بإمكان هذا المستخدم إنشاء المجلدات.
`MANAGE_CONTENT`	بإمكان هذا المستخدم إدارة أصول مجلد عناصر التصميمات.
`MANAGE_PERMISSIONS`	بإمكان هذا المستخدم إدارة أذونات مجلد عناصر تصميمات النشاط التجاري.
`VIEW_CONTENT`	بإمكان هذا المستخدم عرض الأصول في مجلد عناصر التصميمات.
`VIEW_INSIGHTS`	بإمكان هذا المستخدم عرض الرؤى لأصول عناصر التصميمات.

الرؤى

أدوات القياس هذه قيد التطوير.

اسم أداة القياس	الوصف
`impressions`	عدد مرات ظهور الصورة أو الفيديو في الإعلان.
`inline_link_clicks`	عدد مرات النقر على الروابط في الإعلان. تستخدم النقرات على الروابط المضمنة فترة إسناد ثابتة للنقر تبلغ يومًا واحدًا.
`video_play_actions`	عدد مرات تشغيل الفيديو. نحتسب ذلك لكل مرة ظهور للفيديو، ونستثني مرات إعادة التشغيل.
`actions`	إجمالي عدد الإجراءات التي اتخذها الأشخاص والتي تم إسنادها إلى إعلاناتك. قد تتضمن الإجراءات التفاعل أو النقرات أو التحويلات. راجع هذا المستند للحصول على قائمة كاملة بالأنواع المدعومة.
`video_thruplay_watched_actions`	عدد مرات تشغيل الفيديو بالكامل، أو لمدة 15 ثانية على الأقل.
`quality_ranking`	تصنيف لجودة الإعلان المتوقعة. يتم قياس الجودة باستخدام ملاحظات الإعلان وتجربة ما بعد النقر. يتم تصنيف الإعلان مقابل الإعلانات الأخرى التي تنافس على الجمهور ذاته. تتضمن القيم المحتملة ما يلي: `BELOW_AVERAGE_10` `BELOW_AVERAGE_20` `BELOW_AVERAGE_35` `AVERAGE` `ABOVE_AVERAGE` `UNKNOWN`، إذا لم تكن هناك معلومات كافية حول الإعلان. هذا يتعلق بتشخيصات ملاءمة الإعلان.

تتوفر التقسيمات التالية:

age
gender
country
objective
publisher_platform
platform_position
device_platform
optimization_goal