الإصدار 2.10

Graph API | واجهة API التسويق

يتم تصنيف إدخالات سجل التغييرات بالطريقة التالية:

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

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

لم يتم تضمين أهم التغييرات هنا لأنها غير مرتبطة بإصدارات محددة.


Graph API

الطرح في 18 يوليو 2017 | التوفر حتى 7 نوفمبر 2019.


الميزات الجديدة

Webhooks

  • Webhooks لأحداث الصفحة - تعمل الإجراءات التالية الآن على تشغيل تحديث لاشتراكات حقل feed في الصفحة:

    • النشر التلقائي لمناسبة مجدولة
    • التعليق على قصة المناسبة
    • إنشاء مناسبة ونشرها
    • نشر مسودة مناسبة

التغييرات

تخصيصات الائتمان

  • GET /{extended-credit-id} — تمت إعادة تسمية الحقول التالية:

    • تغيير invoice_email إلى extended_credit_emails
    • تغيير invoice_group إلى extended_credit_invoice_groups
    • تغيير sequential_liability_amount إلى allocated_amount
  • GET /{extended-credit-id} — تمت إضافة الحقول التالية:

    • liable_biz_name fields
    • owner_business field مع الحقلين الفرعيين id وname
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id} — تمت إزالة الحقول التالية:

    • business_id field
  • extended_credit_invoice_groups — تمت إضافة الحقول الفرعية التالية:

    • ad_accounts بالحقلين الفرعيين account_id وname
    • email
    • id
    • name
  • CurrencyAmount - ستعرض الحقول التالية الآن كائن CurrencyAmount بدلاً من المبلغ:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

الصفحات

المستخدم

Webhooks

  • فرض قيود التطبيق — سيؤدي تحديد رمز وصول للمستخدم الذي فشل في استيفاء قيود التطبيق (مثل البلد أو العمر) إلى عرض خطأ، ما لم يتم تحديد appsecret_proof في الطلب.

حالات إيقاف الاستخدام

الأحداث

  • GET /{event-id}/videos — تمت إزالة عنصر الربط هذا.

أهم التغييرات خلال 90 يومًا

التعليقات

  • POST وDELETE /{comment-id} — تتطلب هذه العقدة الآن رمز وصول صفحة صالح.

  • POST and DELETE /{object-id}/comments — تتطلب هذه العقدة الآن رمز وصول صفحة صالح.

  • GET /{object-id}/comments— يتطلب عنصر الربط هذا الآن رمز وصول صالح.

عناوين URL

  • POST /{url}— تتطلب هذه العقدة الآن رمز وصول صالح.

  • GET /{url} - لم يعد يتم عرض og_object افتراضيًا، لكن يجب تضمينه في معلمة الحقول.

  • /{url} استخلاص البيانات - لن تستخلص طلبات GET بعد الآن عنوان URL. ويجب استخدام POST /{url} الآن في استخلاص عنوان URL.

المنشورات

  • /{post-id}— تتطلب هذه العقدة الآن رمز وصول صالح.

مقاطع الفيديو

  • /{video-id} — تتطلب هذه العقدة الآن رمز وصول صفحة صالح.

Marketing API

Released July 18, 2017 | Available until May 8, 2018


New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start
  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect
  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website