Versi 8.0

Graph API

Dirilis4 Agustus 2020 | Tersedia sampai 1 November 2022 | Postingan blog

Token Akses

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai 2 November 2020.

• GET /token_deprecation_check

Album

Endpoint yang Berlaku Lagi

Berlaku untuk semua versi.

• GET /{album-id}/likes

Konfigurasi Aplikasi

Jenis Aplikasi

Perubahan ini berlaku untuk semua versi.

Aplikasi yang baru dibuat sekarang dapat memilih Jenis Aplikasi: Bisnis, Gaming, atau Tidak Ada. Ini menyederhanakan antarmuka Tinjauan Aplikasi dengan menghapus Izin dan Fitur yang tidak sesuai berdasarkan jenis yang dipilih. Selain itu, aplikasi yang diketik sebagai aplikasi Bisnis menggunakan mekanisme otorisasi baru, tidak lagi menggunakan mode, dan memiliki akses ke Fitur baru. Baca entri catatan perubahan aplikasi Bisnis untuk detailnya.

Aplikasi Bisnis

Aplikasi berjenis aplikasi Bisnis menggunakan mekanisme otorisasi baru yang disebut Level Akses. Level Akses menggantikan fungsi yang disediakan oleh Mode Pengembangan dan Mode Terbit, yang telah dihapus untuk aplikasi Bisnis, dan menjadikan proses Tinjauan Aplikasi lebih sederhana dan lebih intuitif. Selain itu, Fitur Akses Profil Pengguna Aset Bisnis baru telah dirilis, yang memungkinkan aplikasi Bisnis membaca set kecil kolom Pengguna publik. Perubahan ini dideskripsikan lebih mendetail di bawah.

Level Akses

Berlaku untuk semua versi.

Level Akses adalah mekanisme otorisasi Graph API baru untuk aplikasi Bisnis yang berlaku untuk Izin dan Fitur secara individual. Akses Standar hanya mengizinkan akses ke data milik pengguna yang memiliki Peran di aplikasi, atau Peran dalam Bisnis yang telah mengeklaim aplikasi tersebut. Advanced Access memungkinkan akses ke data milik setiap pengguna aplikasi, tetapi memerlukan Tinjauan Aplikasi. Aplikasi bisnis secara otomatis diberikan Akses Standar untuk semua Izin dan Fitur yang tersedia untuk jenis mereka.

Penghapusan Mode Pengembangan dan Mode Terbit

Berlaku untuk semua versi.

Mode Pengembangan dan Mode Terbit telah dihapus untuk aplikasi berjenis aplikasi Bisnis. Mode ini telah digantikan oleh Level Akses, yang menyediakan fungsi yang sama dan lebih fleksibel - karena aplikasi Bisnis memiliki Akses Standar untuk semua Izin dan Fitur yang tersedia, setiap pengguna dengan Peran di aplikasi, atau Peran dalam Bisnis yang telah mengeklaim aplikasi, dapat memberikan aplikasi Izin yang tersedia kapan saja. Ini menghilangkan kebutuhan untuk Tinjauan Aplikasi atau harus beralih di antara mode selama pengembangan.

Fitur Akses Profil Pengguna Aset Bisnis Baru

Berlaku untuk semua versi.

Fitur Akses Profil Pengguna Aset Bisnis baru memungkinkan aplikasi Bisnis untuk membaca set kecil Kolom publik tentang Pengguna, selama Pengguna terlibat dengan aset milik Bisnis yang telah mengeklaim aplikasi. Baca referensi Akses Profil Pengguna Aset Bisnis untuk daftar Kolom Pengguna yang dapat dibaca.

Komentar

Endpoint yang Berlaku Lagi

Berlaku untuk semua versi.

• GET /{comment-id}/likes

Perangkat

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai 2 November 2020.

• POST /device/share

Grup

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{group-id}/posts

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai 2 November 2020.

• GET /{group-post-id}/likes

Instagram

Endpoint oEmbed Instagram Baru

Berlaku untuk semua versi.

Endpoint GET /instagram_oembed baru telah diperkenalkan. Fungsinya sama seperti endpoint oEmbed legasi Instagram, yang tidak berlaku lagi mulai 24 Okt 2020. Endpoint baru memerlukan token akses, jadi Anda memerlukan akun Developer Facebook dan aplikasi terdaftar untuk mengaksesnya. Baca dokumen oEmbed Instagram untuk petunjuk penggunaan dan detail tambahan.

Peristiwa Penting

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Tautan

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{link-id}/reactions

Video Siaran Langsung

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{live-video-id}/likes

Gunakan endpoint GET /{live-video-id}/reactions untuk mendapatkan reaksi suka dari suatu Video Siaran Langsung.

Parameter save_vod

Berlaku untuk v8.0+. Berlaku untuk semua versi mulai 2 Nov 2020.

Parameter save_vod tidak berlaku lagi untuk edge berikut:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Platform Messenger

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Tinjauan Aplikasi

Berlaku untuk semua versi.

Tinjauan Aplikasi untuk Messenger telah dipindahkan dari Produk > Messenger > Pengaturan ke Tinjauan Aplikasi di dasbor aplikasi. Untuk meminta izin spesifik Messenger, pages_messaging, pages_user_gender, pages_user_locale, dan pages_user_timezone, buka Tinjauan Aplikasi > Izin dan Fitur. Lihat dokumentasi Tinjauan Aplikasi Messenger untuk detail selengkapnya.

Edge Profil Messenger

Berlaku untuk v8.0+.

Jenis menu persisten bersarang tidak berlaku lagi untuk POST /{page-id}/messenger_profile.

Fitur Baru: Messenger untuk Toko

Berlaku untuk v8.0+.

Dukungan untuk mengirim dan menerima produk di Messenger untuk Toko. Ini termasuk Template Produk yang dapat digunakan untuk mengirim produk dalam pesan, Webhooks untuk pesan dengan template produk dan pesan dari Halaman Detail Produk Facebook Shops, dan Webhooks gema untuk pesan dengan produk.

• GET /{message_id}/access_requests
• POST {page_id}/message
• Webhook message_echo
• Webhook messages

Tawaran Native

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{native-offer-id}/nativeofferviews?photos

Graf Terbuka

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku di semua versi mulai 2 Nov 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Halaman

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Postingan Halaman

Tidak berlaku lagi di semua versi.

Format ID komentar Postingan Halaman, {page-id}_{post_id}_{comment-id}, tidak berlaku lagi. Gunakan format {pagepost-id}_{comment-id} sebagai gantinya.

Foto

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di semua versi.

• GET /{photo-id}/sharedposts

Tempat

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{place-information-id} (lihat Koreksi)

Postingan

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku di semua versi mulai 2 Nov 2020.

• GET /{post-id}/likes

Gunakan endpoint GET /post/reactions untuk mendapatkan reaksi suka dari suatu postingan.

Search

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai 2 November 2020.

• GET /search?type=place
• GET /search?type=audience_interest

Pengaturan Keamanan

Kolom-kolom yang Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai Nov 2020.

• secure_browsing

Plugin Sosial

Endpoint oEmbed Facebook

Perubahan ini akan berlaku di semua versi mulai 24 Oktober 2020.

Endpoint oEmbed Facebook, yang mengizinkan aplikasi untuk mendapatkan HTML sematan bagi postingan dan video Facebook publik, tidak berlaku lagi mulai 24 Oktober 2020. Tiga endpoint baru telah diperkenalkan yang menyediakan fungsi yang sama dengan endpoint lama yang mereka gantikan:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

Endpoint baru memerlukan Token Akses dan permintaan akan dikenakan pembatasan laju. Baca dokumentasi endpoint oEmbed baru untuk mengetahui detail penggunaan dan informasi tambahan.

Pengguna

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{user-id}/taggable_friends

Kolom-kolom yang Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku lagi di semua versi mulai Nov 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Tidak berlaku lagi di semua versi.

• can_review_measurement_request
• is_famedeeplinkinguser

Otorisasi Ulang

Perubahan ini berlaku untuk semua versi.

Mulai 24 Okt 2020, kolom berikut akan memerlukan Otorisasi Ulang Akses Data setelah 90 hari tidak aktif:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Gambar Pengguna

Berlaku di semua versi mulai 24 Okt 2020.

Mulai 24 Oktober 2020, endpoint GET /{user-id}/picture (GET /{user-id}?fields=picture) akan memerlukan ID Pengguna Lingkup Aplikasi (ASID) untuk permintaan tanpa token. Jika Anda meng-kueri Pengguna dengan non-ASID, Anda harus menyertakan Token Akses Aplikasi, Klien, atau Pemgguna dalam permintaan. Baca referensi Gambar Pengguna untuk detailnya.

Pertanyaan Video

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+. Tidak berlaku di semua versi mulai 2 Nov 2020.

• GET /{company-id}/access_requests
• GET /access_requests

Marketing API

Dirilis4 Agustus 2020 | Tersedia sampai 4 Mei 2021 | Postingan blog

Akun Iklan

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Izin

Berlaku untuk v8.0+. Berlaku untuk semua versi mulai 2 Nov 2020.

Aplikasi memerlukan izin granular untuk mengakses kolom bisnis suatu Akun Iklan. Izin harus diberikan untuk objek Bisnis tertentu.

Aturan Penyesuaian Aset

Validasi

Berlaku untuk v8.0+.

Semua iklan yang menggunakan asset_feed_spec harus berisi setidaknya dua aturan penyesuaian target. Jika materi iklan Anda menggunakan asset_feed_specdan mencakup kurang dari dua aturan, Anda tidak akan dapat membuat iklan itu.

Perubahan ini memengaruhi Penyesuaian Aset Penempatan, Iklan Multibahasa, dan Penyesuaian Aset Segmen.

Penyesuaian Aset Segmen

Berlaku untuk v8.0+. Berlaku untuk semua versi mulai 2 Nov 2020.

Semua kasus penggunaan yang tidak terkait dengan geolokasi sudah tidak berlaku lagi bagi pengguna Penyesuaian Aset Segmen. Dengan perubahan ini, semua aturan penargetan harus berisi informasi geolokasi di dalam spesifikasi penyesuaiannya. Ada pengecualian untuk aturan default, yang tidak perlu menyertakan geolokasi.

Tawaran

Strategi Penawaran Biaya Target

Berlaku untuk v8.0+

Strategi penawaran TARGET_COST tidak berlaku lagi. Untuk lanjut mengontrol biaya, kami rekomendasikan penggunaan batas biaya penawaran. Lihat semua strategi penawaran yang tersedia.

Pengelola Bisnis

Endpoint Tidak Berlaku Lagi

Tidak berlaku lagi di v8.0+.

• GET{system-user-id}/updated_by

Memperkenalkan Ulang Endpoint Persetujuan Berbagi

Berlaku untuk semua versi

Endpoint berikut telah diperkenalkan kembali:

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Kedua endpoint tersebut sebelumnya tidak berlaku lagi dengan diluncurkannya Graph API V6.0.

Canvas

Endpoint Tidak Berlaku Lagi

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

Catalog API

Izin

Berlaku untuk v8.0+. Akan berlaku untuk semua versi mulai 31 Januari 2021.

Anda tidak memerlukan lagi izin ads_management untuk mengakses endpoint katalog produk. Ke depannya, Anda akan memerlukan izin catalog_management untuk memanggil endpoint tersebut. Developer yang memiliki akses ke endpoint katalog melalui ads_management dalam 90 hari terakhir akan dimigrasi secara otomatis ke izin catalog_management paling lambat 14 Agustus 2020.

Mulai sekarang sampai 28 Februari 2021, developer yang menggunakan versi API sebelumnya masih dapat memanggil endpoint katalog produk dengan izin ads_management. Jika Anda menggunakan v8.0, Anda harus memiliki izin catalog_management.

Setelah tenggat Februari, izin catalog_management tidak akan terkait lagi dengan ads_management, sehingga pengguna harus memberikan izin catalog_management secara eksplisit untuk aplikasi Anda.

Autentikasi

Berlaku untuk v8.0+. Berlaku untuk semua versi mulai 2 Nov 2020.

[DIPERBARUI] Endpoint API Katalog berikut sekarang menerapkan pengaturan Bisnis autentikasi dua faktor. Setiap aplikasi yang memanggil endpoint ini akan menerima pesan kesalahan jika Bisnis yang memiliki katalog mewajibkan autentikasi dua faktor untuk pengguna aplikasi saat ini dan pengguna aplikasi belum mengautentikasi melalui dua faktor.

Ketika pengguna aplikasi saat ini memiliki akses ke katalog melalui bisnis partner, kami menghormati persyaratan autentikasi dari Pengelola Bisnis partner. Pengguna sistem tidak harus melakukan autentikasi dua faktor.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Pelaporan

Tidak Berlaku Lagi

Berlaku untuk v8.0+

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Penargetan

Tidak Berlaku Lagi

Berlaku untuk v8.0+

• GET /search?type=adzipcode

Koreksi

• 28 September 2020 — Entri autentikasi API Katalog diperbarui agar lebih jelas.
• 23 Oktober 2020 — Entri API Katalog API diperbarui:

  • Kami memperpanjang tenggat ketika developer yang menggunakan API versi sebelumnya masih dapat memanggil endpoint katalog produk dengan izin ads_management. Tenggat barunya 28 Februari 2021.
  • Kami menambahkan klarifikasi tentang autentikasi pengguna sistem.
• 17 Mei 2021 — Mengubah endpoint yang tidak berlaku dari GET /{place-id} menjadi GET /{place-information-id}. GET /{place-id} masih berlaku.