Permintaan ke ReachPlanService harus
menyediakan kredensial OAuth, dan ID pelanggan yang dapat diakses oleh kredensial OAuth Anda. Selain itu, project Google Cloud yang memiliki kredensial OAuth harus disetujui untuk menggunakan layanan ini.
Panduan ini membahas detail autentikasi khusus untuk
ReachPlanService. Jika belum,
selesaikan terlebih dahulu langkah-langkah yang diuraikan di
Memulai, lalu kembali ke poin ini.
Kredensial OAuth
Selain panduan yang diberikan oleh Memulai, perhatikan poin-poin berikut:
- Nomor project Google Cloud Anda harus ditambahkan ke daftar yang diizinkan yang sesuai
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 akan memengaruhi integrasi Anda dan dijelaskan 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 OAuth
kredensial 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 Anda,
buat kredensial OAuth menggunakan alur autentikasi satu pengguna untuk pengguna yang memiliki akses ke
akun pengelola 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.
Perencana dengan akses akun klien
Jika perencana Anda memiliki akses ke akun pengelola Google Ads yang mengelola akun klien Anda, terapkan alur autentikasi multi-pengguna agar aplikasi Anda dapat menggunakan kredensial OAuth perencana Anda. Kemudian, Anda dapat meneruskan ID pelanggan yang sesuai dengan pelanggan rencana Anda.
Alat eksternal
Jika Anda membuat alat untuk pengguna eksternal, sebaiknya gunakan pendekatan yang serupa:
Per akun klien
Buat kredensial OAuth menggunakan alur autentikasi satu pengguna untuk pengguna yang memiliki akses ke akun pengelola Anda. Buat akun Google Ads per klien eksternal dan tautkan ke akun pengelola Anda. Kemudian, konfigurasi alat Anda untuk memberikan ID pelanggan yang sesuai dengan klien saat mereka membuat rencana.
Akses yang diberikan pengguna
Berikan kemampuan kepada pengguna untuk memberikan akses alat Anda ke akun mereka
menggunakan alur autentikasi multi-pengguna. Setelah pengguna memberikan
izin, gunakan
CustomerService untuk memberi
mereka daftar akun Google Ads yang dapat mereka akses.
Tujuannya adalah untuk memastikan perencana memiliki 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 pertama yang disarankan untuk jenis alat Anda.
Langkah berikutnya
Pelajari cara Menentukan rencana media.