Permintaan ke ReachPlanService harus
memberikan token developer yang disetujui, kredensial OAuth, dan ID pelanggan yang
dapat diakses kredensial OAuth Anda.
Panduan ini membahas detail autentikasi khusus untuk
ReachPlanService. Jika belum melakukannya,
selesaikan langkah-langkah yang diuraikan dalam artikel Mulai
terlebih dahulu, lalu kembali ke poin ini.
Token developer dan kredensial OAuth
Selain panduan yang disajikan oleh artikel Memulai, perhatikan hal-hal 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 Anda menentukan ID pelanggan mana yang dapat Anda kueri di
ReachPlanService. Hal ini menginformasikan integrasi Anda dan dijelaskan secara lebih detail 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 kuerinya, serta 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 tertentu tempat Anda akan menjalankan kampanye.
Bagi partner yang membuat alat untuk penggunaan internal di organisasi mereka, sebaiknya pilih salah satu pilihan berikut:
Jika perencana 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. Selanjutnya, buat atau dapatkan akun Google Ads untuk setiap tim yang menggunakan alat Anda, lalu tautkan mereka ke akun pengelola Anda. Saat membuat permintaan ke
ReachPlanService, berikan ID pelanggan yang sesuai dengan tim pengguna.Jika perencana Anda memiliki akses ke akun pengelola Google Ads yang mengelola akun klien Anda: Terapkan alur aplikasi web agar aplikasi Anda dapat menggunakan kredensial OAuth perencana Anda. Kemudian, Anda dapat meneruskan ID pelanggan yang sesuai dengan pelanggan paket Anda.
Untuk partner yang membuat alat bagi pengguna eksternal, kami merekomendasikan pendekatan yang serupa:
Buat kredensial OAuth menggunakan alur aplikasi yang diinstal untuk pengguna yang memiliki akses ke akun pengelola token developer Anda. Buat akun Google Ads untuk setiap klien eksternal dan tautkan akun tersebut ke akun pengelola Anda. Kemudian, konfigurasikan alat Anda untuk memberikan ID pelanggan yang sesuai milik klien saat membuat paket.
Beri pengguna kemampuan untuk memberi alat Anda akses ke akun mereka menggunakan alur aplikasi web. Setelah pengguna memberikan izin, gunakan
CustomerServiceuntuk memberi mereka daftar akun Google Ads yang dapat mereka akses.
Tujuannya adalah untuk memastikan perencana memiliki friksi 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 pertama yang disarankan untuk
jenis alat Anda.