Permintaan ke ReachPlanService
harus
menyediakan token developer, kredensial OAuth, dan ID pelanggan yang disetujui yang
dapat diakses oleh kredensial OAuth Anda.
Panduan ini membahas detail autentikasi khusus untuk
ReachPlanService
. Jika belum melakukannya,
selesaikan terlebih dahulu langkah-langkah yang diuraikan dalam Memulai, lalu kembali ke titik ini.
Token developer dan kredensial OAuth
Selain panduan yang dijelaskan dalam artikel Memulai, perhatikan poin-poin berikut:
- Token developer Anda harus diizinkan untuk terhubung ke
ReachPlanService
, meskipun sudah disetujui untuk digunakan dengan layanan Google Ads API lainnya. Untuk mengetahui informasi selengkapnya, lihat persyaratan kelayakan. - Anda harus menyetujui Persyaratan Layanan Google Ads API agar dapat terhubung ke Google Ads API.
- Pengguna yang memiliki token refresh OAuth menentukan ID pelanggan yang dapat Anda buat kuerinya di
ReachPlanService
. Hal ini akan memberi tahu integrasi Anda dan dijelaskan dalam detail selengkapnya di bawah.
ID Pelanggan
Sebagian besar layanan dalam Google Ads API beroperasi pada akun dan kampanye Google Ads tertentu. Akibatnya, sebagian besar permintaan memerlukan ID pelanggan untuk mengidentifikasi
akun yang Anda kelola atau buat kueri, dan kredensial
OAuth yang memiliki izin untuk mengakses
ID pelanggan tersebut. Namun, ReachPlanService
dimaksudkan untuk aktivitas perencanaan video yang mungkin terjadi sebelum Anda mengetahui
ID pelanggan spesifik yang akan menjalankan kampanye.
Bagi partner yang membuat alat untuk penggunaan internal di organisasi mereka, kami merekomendasikan salah satu pilihan berikut:
Jika planner Anda tidak memiliki akses ke akun Google Ads klien Anda: Buat kredensial OAuth menggunakan alur aplikasi terinstal untuk pengguna yang memiliki akses ke akun pengelola token developer Anda. Kemudian, buat atau dapatkan akun Google Ads untuk setiap tim yang menggunakan alat Anda, dan tautkan ke akun pengelola Anda. Saat membuat permintaan ke
ReachPlanService
, berikan ID pelanggan yang sesuai dengan tim pengguna.Jika planner Anda memiliki akses ke akun pengelola Google Ads yang mengelola akun klien Anda: Terapkan alur aplikasi web untuk mengizinkan aplikasi Anda menggunakan kredensial OAuth perencana Anda. Kemudian, Anda dapat meneruskan ID pelanggan yang sesuai dengan pelanggan paket Anda.
Bagi partner yang membuat alat untuk pengguna eksternal, sebaiknya gunakan pendekatan yang serupa:
Buat kredensial OAuth menggunakan alur aplikasi terinstal untuk pengguna yang memiliki akses ke akun pengelola token developer Anda. Buat akun Google Ads per klien eksternal dan tautkan akun tersebut ke akun pengelola Anda. Kemudian, konfigurasikan alat Anda untuk memberikan ID pelanggan yang sesuai dari klien saat mereka membuat rencana.
Beri pengguna kemampuan untuk memberi alat Anda akses ke akun mereka menggunakan alur aplikasi web. Setelah pengguna memberikan izin, gunakan
CustomerService
untuk memberi mereka daftar akun Google Ads yang dapat mereka akses.
Tujuannya adalah untuk memastikan perencana mendapatkan hambatan serendah mungkin saat menggunakan
ReachPlanService
. Sebelum mengintegrasikan
API, pilih salah satu dari dua pendekatan sesuai dengan situasi Anda dan identifikasi
beberapa ID pelanggan untuk diuji. Jika ragu, gunakan pendekatan yang disarankan pertama untuk
jenis alat Anda.