Versi 2.10

API Graf | API Marketing

Entri catatan perubahan digolongkan berdasarkan kategori berikut:

  • Fitur Baru — Produk atau layanan baru, termasuk node, edge, dan kolom baru.
  • Perubahan — Perubahan terhadap produk atau layanan yang sudah ada (tidak termasuk Penghentian).
  • Penghentian — Produk atau layanan yang tengah dihapus.
  • Breaking Changes 90-Hari — Perubahan dan penghentian yang akan berlaku 90 hari sejak tanggal perilisan versi.

Fitur Baru, Perubahan, dan Penghentian hanya berdampak pada versi ini. Breaking Changes 90-Hari mempengaruhi semua versi.

Breaking Changes tidak diikutsertakan di sini karena tidak terikat ke rilisan tertentu.


API Graf

Dirilis 18 Juli 2017 | Tersedia hingga 7 November 2019


Fitur Baru

Webhook

  • Webhook untuk Peristiwa Halaman - Tindakan berikut sekarang akan memicu pembaruan untuk langganan kolom Halaman feed:

    • Menerbitkan peristiwa terjadwal secara otomatis
    • Mengomentari cerita peristiwa
    • Membuat dan menerbitkan peristiwa
    • Menerbitkan konsep peristiwa

Perubahan

Alokasi Kredit

  • GET /{extended-credit-id} — Kolom berikut telah diganti nama:

    • invoice_email menjadi extended_credit_emails
    • invoice_group menjadi extended_credit_invoice_groups
    • sequential_liability_amount menjadi allocated_amount
  • GET /{extended-credit-id} — Kolom berikut telah ditambahkan:

    • liable_biz_name fields
    • owner_business field dengan subkolom id dan name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id} — Kolom berikut telah dihapus:

    • business_id field
  • extended_credit_invoice_groups - Subkolom berikut telah ditambahkan:

    • Subkolom ad_accounts dengan account_id dan name
    • email
    • id
    • name
  • CurrencyAmount - Kolom berikut dengan sekarang akan mengembalikan objek CurrencyAmount alih-alih jumlah:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Halaman

Pengguna

Webhook

  • Penegakan Batasan Aplikasi — Menentukan token akses untuk pengguna yang gagal dalam batasan aplikasi (seperti negara atau usia) akan menghasilkan kesalahan, kecuali appsecret_proof ditentukan dalam permintaan.

Penghentian

Peristiwa

  • GET /{event-id}/videos — Edge ini sudah dihapus.

Breaking Changes 90-Hari

Komentar

  • POST dan DELETE /{comment-id} — Node ini sekarang memerlukan token akses halaman yang valid.

  • POST and DELETE /{object-id}/comments — Node ini sekarang memerlukan token akses halaman yang valid.

  • GET /{object-id}/comments - Edge ini sekarang memerlukan token akses yang valid.

URL

  • POST /{url} - Node ini sekarang memerlukan token akses yang valid.

  • GET /{url} - og_object tidak lagi dikembalikan secara default namun harus disertakan di parameter kolom.

  • /{url} Scraping - Permintaan GET tidak lagi melakukan scrape pada URL. POST /{url} sekarang harus digunakan untuk melakukan scrape pada URL.

Postingan

  • /{post-id} - Node ini sekarang memerlukan token akses yang valid.

Video

  • /{video-id} - Node ini sekarang memerlukan token akses halaman yang valid.

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