Permintaan ke ReachPlanService harus
menyediakan token developer yang disetujui, kredensial OAuth, dan ID pelanggan yang dapat diakses oleh kredensial OAuth Anda.
Panduan ini mencakup detail autentikasi khusus untuk
ReachPlanService. Jika Anda belum melakukannya,
selesaikan terlebih dahulu langkah-langkah yang diuraikan dalam Mulai, lalu kembali ke langkah ini.
Token developer dan kredensial OAuth
Selain panduan yang disajikan oleh Mulai, perhatikan poin-poin berikut:
- Token developer Anda harus ditambahkan ke daftar yang diizinkan yang sesuai untuk terhubung ke
ReachPlanService, meskipun token tersebut 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 untuk terhubung ke Google Ads API.
- Pengguna yang memiliki token refresh OAuth Anda menentukan ID pelanggan yang dapat Anda kueri di
ReachPlanService. Hal ini memengaruhi integrasi Anda dan dijelaskan secara lebih mendetail di bagian berikut.
ID Pelanggan
Sebagian besar layanan dalam Google Ads API beroperasi di akun dan kampanye Google Ads tertentu. Oleh karena itu, sebagian besar permintaan memerlukan ID pelanggan untuk mengidentifikasi akun yang Anda kelola atau kueri, dan kredensial OAuth yang memiliki izin untuk mengakses ID pelanggan tersebut. Namun, ReachPlanService
ditujukan untuk aktivitas perencanaan video yang mungkin terjadi sebelum Anda mengetahui
ID pelanggan tertentu tempat Anda akan menjalankan kampanye.
Alat internal
Jika Anda membuat alat untuk penggunaan internal di organisasi Anda, berikut rekomendasi kami.
Perencana tanpa akses akun klien langsung
Jika perencana Anda tidak memiliki akses ke akun Google Ads klien, buat kredensial OAuth menggunakan alur aplikasi yang diinstal 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, lalu tautkan akun tersebut ke
akun pengelola Anda. Saat membuat permintaan ke
ReachPlanService, berikan ID pelanggan
yang sesuai dengan tim pengguna.
Perencana dengan akses akun klien
Jika perencana 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.
Alat eksternal
Jika Anda membuat alat untuk pengguna eksternal, sebaiknya gunakan pendekatan yang serupa:
Akun per klien
Buat kredensial OAuth menggunakan alur aplikasi terinstal untuk pengguna dengan akses ke akun pengelola token developer Anda. Buat akun Google Ads untuk setiap klien eksternal dan tautkan akun tersebut ke akun pengelola Anda. Kemudian, konfigurasi alat Anda untuk memberikan ID pelanggan yang sesuai dengan klien saat mereka membuat rencana.
Akses yang diberikan pengguna
Beri pengguna kemampuan untuk memberikan akses alat Anda ke akun mereka
dengan menggunakan alur aplikasi web. Setelah pengguna memberikan izin, gunakan
CustomerService untuk memberi
mereka daftar akun Google Ads yang dapat mereka akses.
Tujuannya adalah memastikan perencana memiliki hambatan serendah mungkin saat menggunakan
ReachPlanService. Sebelum mengintegrasikan
API, pilih salah satu dari dua pendekatan sesuai situasi Anda dan identifikasi
beberapa ID pelanggan untuk diuji. Jika ragu, gunakan pendekatan pertama yang disarankan untuk
jenis alat Anda.
Langkah berikutnya
Pelajari cara Menentukan rencana media.