Permintaan ke ReachPlanService harus menyediakan kredensial OAuth dan ID pelanggan yang dapat diakses oleh kredensial OAuth Anda. Selain itu, project Google Cloud yang terkait dengan kredensial OAuth Anda harus disetujui untuk menggunakan layanan ini.
Panduan ini membahas detail autentikasi khusus untuk ReachPlanService. Jika Anda belum melakukannya, selesaikan terlebih dahulu langkah-langkah yang diuraikan dalam Memulai, lalu kembali ke panduan ini.
Kredensial OAuth
Selain panduan yang disajikan dalam 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 untuk terhubung ke Google Ads API.
- Pengguna yang memiliki token refresh OAuth Anda menentukan ID pelanggan yang dapat Anda buat kuerinya di
ReachPlanService. Hal ini akan menginformasikan 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 target dan kredensial OAuth yang diberi otorisasi untuk mengakses ID pelanggan tersebut.
Namun, ReachPlanService ditujukan untuk aktivitas perencanaan video yang mungkin terjadi sebelum Anda membuat akun pelanggan tertentu untuk menjalankan kampanye.
Alat internal
Jika Anda membangun alat untuk penggunaan internal dalam organisasi, pertimbangkan opsi berikut:
- Planner tanpa akses akun klien langsung: Jika planner Anda tidak
memiliki akses ke akun Google Ads klien, buat kredensial OAuth
menggunakan alur autentikasi pengguna tunggal
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. - Planner dengan akses akun klien: Jika planner 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 planner Anda. Kemudian, Anda dapat meneruskan ID pelanggan yang sesuai dengan paket pelanggan.
Alat eksternal
Jika Anda membuat alat untuk pengguna pihak ketiga atau eksternal, sebaiknya gunakan opsi berikut:
- Akun per klien: Buat kredensial OAuth menggunakan alur autentikasi pengguna tunggal untuk pengguna dengan akses ke akun pengelola Anda. Buat akun Google Ads per klien eksternal dan tautkan ke akun pengelola Anda. Konfigurasi alat Anda untuk memberikan ID pelanggan yang sesuai saat membuat rencana.
- Akses yang diberikan pengguna: Izinkan pengguna memberikan akses ke akun mereka kepada alat Anda menggunakan alur autentikasi multi-pengguna. Setelah pengguna memberikan izin, gunakan
CustomerServiceuntuk mengambil daftar akun Google Ads yang dapat mereka akses.
Sebelum mengintegrasikan API, pilih salah satu pendekatan sebelumnya berdasarkan persyaratan sistem Anda dan identifikasi beberapa ID pelanggan pengujian. Jika ragu, mulailah dengan alur autentikasi pengguna tunggal dengan akun tertaut.
Langkah berikutnya
Pelajari cara menentukan media plan.