Graph API

Versi 3.1

Dirilis 26 Juli 2018 | Tersedia hingga 27 Oktober 2020 | Postingan Blog

Umum

Perubahan ini berlaku untuk v3.1+, dan akan berlaku ke semua versi mulai 24 Oktober 2018.

Semua endpoint API Graf sekarang akan mengembalikan semua struktur kosong sebagai {}, dan semua daftar kosong sebagai [].

Live API

Perubahan ini berlaku untuk v3.1+, dan akan berlaku ke semua versi mulai 24 Oktober 2018.

Parameter type sudah dihentikan untuk edge berikut. Parameter ini diganti dengan parameter source baru.

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

Parameter source baru bisa menerima satu dari dua kemungkinan nilai: target dan owner. Kueri edge /live_videos dengan source=target mengembalikan video siaran langsung yang disiarkan ke node tersebut, sementara kueri untuk source=owner mengembalikan video siaran langsung yang disiarkan oleh node tersebut.

Node Peristiwa dan Grup hanya mendukung kueri target, dan beberapa kueri target mungkin gagal jika Anda tidak memiliki izin untuk melihat node ditargetkan.

Marketing API

Dirilis 26 Juli 2018 | Tersedia Hingga 14 Mei 2019 | Postingan Blog

Pengelolaan Iklan

  • Kategori Penargetan berbasis Perilaku - Kami menghentikan beberapa opsi penargetan berbasis perilaku yang digunakan di behaviors. Jika Anda mencoba membuat iklan dengan salah satu kategori ini, Anda akan mendapatkan kesalahan The category you selected is no longer available. Untuk memeriksa kategori valid yang tersedia untuk penargetan, gunakan Pencarian Penargetan.

  • MenghentikanPAGE_ENGAGEMENTsebagaioptimization_goal - Kami menghentikan PAGE_ENGAGEMENT sebagai optimization_goal untuk kampanye iklan. Mulai v3.1, Anda tidak lagi dapat membuat, mengupdate, atau menduplikasi kampanye iklan dengan optimization_goal diatur ke PAGE_ENGAGEMENT. Jika ada kampanye iklan yang dibuat sebelum v3.1, Anda masih dapat menjalankan kampanye tersebut dengan pengaturan ini. Anda juga masih dapat menggunakan PAGE_ENGAGEMENT sebagai perincian API Insight untuk data tentang kampanye iklan yang sudah ada menggunakan optimization_goal ini.

  • Menghentikan Iklan Suka Halaman dengan Gambar Tunggal tanpa Postingan - Mulai v3.1, Anda tidak lagi dapat membuat Iklan Suka Halaman dengan gambar tunggal tanpa postingan halaman. Sebagai gantinya, Anda harus membuat Iklan Suka Halaman dengan postingan, buka Materi Iklan, Penempatan, dan Pratinjau, Membuat Iklan Suka Halaman.

  • Tidak Ada Pengambilan Iklan Prospek melalui Webhook untuk Tingkat Developer - Kami akan berhenti mengirimkan data yang dikumpulkan dalam formulir Iklan Prospek melalui webhook ke aplikasi dalam Mode Developer. Kami mulai menerapkan perubahan ini pada 1 Februari 2019.

    • Jika Anda berlangganan update dalam v3.1, kami tidak akan mengirimkan update kecuali aplikasi Anda dalam tahap produksi dan dalam Mode Terbit.

    • Jika Anda membuat aplikasi baru setelah v3.1 tersedia, kami tidak akan mengirimkan update kecuali aplikasi Anda dalam tahap produksi dan dalam Mode Terbit.

    • Jika Anda sudah memiliki aplikasi, aplikasi itu akan harus berada dalam Mode Terbit paling lambat 1 Februari 2019. Hingga tanggal itu, Anda akan terus menerima pembaruan dalam Mode Developer.

    Untuk informasi selengkapnya tentang tingkat akses API Marketing dan mode aplikasi, buka New Struktur Baru untuk Akses API Marketing dan API Marketing, Akses, dan Autentikasi.

Wawasan Iklan dan Pengukuran

  • Kami mengganti nama cost_per_store_visit dan store_visits untuk API Insight menjadi cost_per_store_visit_actions dan store_visit_actions. Ini berdampak pada:

    • GET {adaccount-id}/insights,

    • GET {campaign-id}/insights,

    • GET {adset-id}/insights,

    • GET {ad-id}/insights,

    • POST {adaccount-id}/insights,

    • POST {campaign-id}/insights,

    • POST {adset-id}/insights, dan

    • POST {ad-id}/insights.

    Untuk informasi mengenai metrik-metrik dengan nama yang baru diganti, buka Kunjungan Toko, Pengukuran. Perlu diperhatikan bahwa API Kunjungan Toko dan dokumentasi terkait tersedia secara terbatas. Hubungi Perwakilan Facebook Anda untuk memperoleh aksesnya.

API Pengelola Bisnis

Dalam v3.1, kami memperkenalkan konsep baru izin berbasis tugas untuk menggantikan izin berbasis peran saat ini. Ini berdampak pada akses ke akun iklan yang dikelola oleh API Pengelola Bisnis dan Halaman. Akses berbasis peran ke akun iklan dan Halaman masih tersedia tetapi nanti akan berhenti didukung. Ini berdampak pada peran-peran berikut dan memberikan tugas-tugas penggantinya untuk akun iklan:

Peran Tugas Deskripsi

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

Mengelola semua aspek kampanye iklan, pelaporan, penagihan, dan izin akun iklan.

GENERAL_USER

['ADVERTISE', 'ANALYZE']

Membuat iklan menggunakan sumber dana yang terkait dengan akun iklan. Menjalankan laporan.

GENERAL_USER

['ANALYZE']

Menjalankan laporan.

Ini menggantikan peran-peran berikut dalam API Pengelola Bisnis dengan tugas-tugas berikut:

Peran Tugas

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

Untuk manajemen Piksel Facebook, ini memengaruhi peran dan memperkenalkan tugas baru:

Peran Tugas

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

Sebagai bagian dari perubahan ini, kami akan berhenti mendukung kolom API Pengelolaan Bisnis berikut dan menggantikannya dengan yang berikut ini:

Area Berhenti Didukung Kolom Baru

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

Desain baru ini juga memengaruhi API Halaman, buka API Graf 3.1, API Halaman, Breaking Change. Untuk dokumentasi API Pengelola Bisnis, lihat:

Platform Messenger

Untuk aplikasi yang dibuat sebelum 26 Juli 2018, perubahan ini berlaku pada 8 Januari 2019. Untuk aplikasi yang dibuat setelah 26 Juli 2018, perubahan ini berlaku segera.

API Profil Pengguna sekarang hanya mengembalikan kolom first_name, last_name, dan profile_pic secara default. Kolom tambahan sekarang memerlukan tinjauan produk melalui tab Platform Messenger pada Dasbor Aplikasi.

Kolom last_ad_referral dan is_payment_enabled dihentikan, dan akan dihapus dari API pada 30 Oktober 2018.

API Teman Bersama

Perubahan ini berlaku untuk v3.1+, dan akan berlaku ke semua versi mulai 24 Oktober 2018.

API Teman Bersama dihentikan pada 4 April 2018, dan endpoint di bawah dimulai dengan mengembalikan set data kosong. Endpoint ini sekarang benar-benar sudah dihentikan dan akan mengembalikan pesan kesalahan.

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

API Halaman

Izin

Perubahan berikut berlaku untuk v3.1+, dan akan berlaku ke semua versi mulai 1 Februari 2019.

Izin pages_manage_cta sekarang memerlukan Tinjauan Aplikasi untuk semua permintaan POST dan DELETE. Aplikasi yang dibuat sebelum 26 Juli 2018 bisa tetap menggunakan izin ini, tetapi harus diajukan untuk tinjauan aplikasi sebelum 1 Februari 2019 untuk tetap bisa menggunakan pages_manage_cta.

Peran Halaman

Perubahan berikut berlaku untuk v3.1+.

Peran Halaman sedang dalam proses penghentian dan akan diganti dengan Tugas halaman. Alih-alih memberikan peran kepada Pengguna di Halaman, sekarang Anda dapat memberikan yang setara di tugas kepada Pengguna.

PeranTugas Setara

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

Hingga izin berbasis peran sepenuhnya diganti oleh izin berbasis tugas, saat memberikan tugas melalui /page/roles, Anda harus memberi semua tugas ekuivalen untuk sebuah peran, jika tidak, maka operasi POST akan gagal.

Untuk mendukung perubahan ini, kolom perms dan role sudah dihentikan dan diganti dengan kolom tasks baru. Ini berdampak pada edge berikut:

  • /me/accounts
  • /page/roles
  • /user/accounts

Lihat catatan perubahan API Pemasaran untuk melihat bagaimana perubahan ini mempengaruhi API Pemasaran dan API Pengelola Bisnis.

Webhook

Perubahan ini berlaku untuk v3.1+, dan akan berlaku ke semua versi mulai 24 Oktober 2018.

Kolom webhook Pengguna dihentikan:

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

Kolom webhook Pengguna berikut sekarang menggunakan URL HTTPS alih-alih HTTP.

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

Selain itu, URL untuk kolom ini akan kedaluwarsa — ini akan segera mempengaruhi semua versi API.