Permintaan ke ReachPlanService harus
menyediakan token developer yang disetujui, kredensial OAuth, dan ID pelanggan yang
dapat diakses oleh kredensial OAuth Anda.
Panduan ini membahas detail autentikasi khusus untuk
ReachPlanService. Jika Anda belum melakukannya,
selesaikan terlebih dahulu langkah-langkah yang diuraikan di
Memulai, lalu kembali ke poin ini.
Token developer dan kredensial OAuth
Selain panduan yang diberikan oleh Memulai, 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 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 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 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 token developer Anda. Kemudian, buat atau dapatkan
akun Google Ads untuk setiap tim yang menggunakan alat Anda, dan 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 autentikasi multi-pengguna untuk mengizinkan aplikasi Anda 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 serupa:
Per akun klien
Buat kredensial OAuth menggunakan alur autentikasi satu pengguna 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, konfigurasi alat Anda untuk memberikan ID pelanggan yang sesuai dengan klien saat mereka membuat rencana.
Akses yang diberikan pengguna
Berikan kemampuan kepada pengguna Anda 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.