Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord Google Ads resmi di server Komunitas Iklan dan Pengukuran Google.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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 dimasukkan dalam daftar yang diizinkan untuk terhubung ke
ReachPlanService, meskipun token tersebut
telah 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 akan memengaruhi integrasi Anda dan dijelaskan lebih mendetail di bawah.
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.
Untuk partner yang membuat alat untuk penggunaan internal di organisasi mereka, sebaiknya pilih salah satu opsi berikut:
Jika perencana Anda tidak memiliki akses ke akun Google Ads klien Anda:
Buat kredensial OAuth menggunakan alur aplikasi yang diinstal untuk pengguna
dengan 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.
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.
Untuk partner yang membuat alat bagi pengguna eksternal, sebaiknya gunakan pendekatan serupa:
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.
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 diakses.
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.
[null,null,["Terakhir diperbarui pada 2025-08-27 UTC."],[[["\u003cp\u003eThe ReachPlanService API requires allowlisted access, an approved developer token, OAuth credentials, and a valid customer ID.\u003c/p\u003e\n"],["\u003cp\u003eYour developer token needs to be specifically allowlisted for ReachPlanService, and you must accept the Google Ads API Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eCustomer ID selection depends on whether planners have access to client accounts or use a manager account, impacting OAuth credential flow.\u003c/p\u003e\n"],["\u003cp\u003ePartners building internal tools can choose between using a manager account with linked team accounts or leveraging planners' existing manager account access.\u003c/p\u003e\n"],["\u003cp\u003ePartners building external tools can use a similar approach, either linking client accounts to a manager account or utilizing the web application flow for direct user account access.\u003c/p\u003e\n"]]],[],null,["# Authentication\n\n| **Important:** This feature is available to allowlisted accounts only. Contact your Google representative if you need access to the feature.\n\n\u003cbr /\u003e\n\nRequests to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) must\nsupply an approved developer token, OAuth credentials, and a customer ID that\nyour OAuth credentials can access.\n\nThis guide covers authentication details specific to\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). If you haven't already,\nfirst complete the steps outlined in [Get\nstarted](/google-ads/api/docs/get-started/introduction), then come back to this point.\n\nDeveloper token and OAuth credentials\n-------------------------------------\n\nIn addition to the guidance presented by [Get\nstarted](/google-ads/api/docs/get-started/introduction), keep the following points in mind:\n\n1. Your developer token must be allowlisted to connect to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService), even if it's already approved for use with other Google Ads API services. For more information, see the [eligibility\n requirements](/google-ads/api/docs/reach-forecasting#eligibility).\n2. You must accept the Google Ads API Terms of Service in order to connect to the Google Ads API.\n3. The user who owns your OAuth refresh token determines which customer IDs you can query in the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). This informs your integration and is explained in more details below.\n\nCustomer IDs\n------------\n\nMost services within the Google Ads API operate on specific Google Ads accounts and\ncampaigns. As a result, most requests require both a customer ID to identify\nthe account you're managing or querying, and [OAuth\ncredentials](/google-ads/api/docs/oauth/overview) that have permission to access that\ncustomer ID. However, [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService)\nis meant for video planning activities that might occur before you know the\nspecific customer ID where you would run a campaign.\n\nFor partners who build tools for internal use in their organization, we\nrecommend one of the following choices:\n\n1. **If your planners don't have access to your clients' Google Ads accounts** :\n Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Then create or obtain\n a Google Ads account for each team that uses your tool, and [link them to\n your manager account](//support.google.com/google-ads/answer/7459601). When making requests to\n [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) provide the customer ID\n corresponding to a user's team.\n\n2. **If your planners have access to a Google Ads manager account that manages\n your clients' accounts** : Implement the *web application flow* to allow your\n app to use your planners' OAuth credentials. Then you can pass in the\n customer ID corresponding to the customer of your plan.\n\nFor partners who build a tool for external users, we recommend similar\napproaches:\n\n1. Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Create a Google Ads\n account per external client and [link them to your manager\n account](//support.google.com/google-ads/answer/7459601). Then configure your tool to provide a client's\n corresponding customer ID when they're generating plans.\n\n2. Give your users the ability to grant your tool access to their accounts\n by using the *web application flow* . Once a user grants permission, use the\n [`CustomerService`](/google-ads/api/docs/account-management/listing-accounts) to provide\n them with a list of Google Ads accounts they can access.\n\nThe goal is to ensure planners have the lowest possible friction when using the\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). Before you integrate the\nAPI, select one of the two approaches according to your situation and identify\na few customer IDs to test. If in doubt, use the first suggested approach for\nyour tool type."]]
