개발자 토큰이 다른 Google Ads API 서비스에서 사용하도록 이미 승인된 경우에도 ReachPlanService에 연결하려면 개발자 토큰이 허용 목록에 추가되어야 합니다. 자세한 내용은 자격 요건을 참고하세요.
Google Ads API에 연결하려면 Google Ads API 서비스 약관에 동의해야 합니다.
OAuth 새로고침 토큰을 소유한 사용자가 ReachPlanService에서 쿼리할 수 있는 고객 ID를 결정합니다.
이는 통합에 영향을 미치며 아래에 자세히 설명되어 있습니다.
고객 ID
Google Ads API 내 대부분의 서비스는 특정 Google Ads 계정 및 캠페인에서 작동합니다. 따라서 대부분의 요청에는 관리하거나 쿼리하는 계정을 식별하는 고객 ID와 해당 고객 ID에 액세스할 수 있는 권한이 있는 OAuth 사용자 인증 정보가 모두 필요합니다. 하지만 ReachPlanService는 캠페인을 운영할 특정 고객 ID를 알기 전에 발생할 수 있는 동영상 계획 활동을 위한 것입니다.
조직 내에서 사용할 도구를 빌드하는 파트너에게는 다음 옵션 중 하나를 권장합니다.
플래너가 고객의 Google Ads 계정에 액세스할 수 없는 경우:
개발자 토큰의 관리자 계정에 액세스할 수 있는 사용자의 설치된 애플리케이션 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 그런 다음 도구를 사용하는 각 팀의 Google Ads 계정을 만들거나 가져와서 관리자 계정에 연결합니다. ReachPlanService에 요청할 때는 사용자의 팀에 해당하는 고객 ID를 제공하세요.
플래너가 고객의 계정을 관리하는 Google Ads 관리자 계정에 액세스할 수 있는 경우: 앱에서 플래너의 OAuth 사용자 인증 정보를 사용할 수 있도록 웹 애플리케이션 흐름을 구현합니다. 그런 다음 요금제 고객에 해당하는 고객 ID를 전달할 수 있습니다.
외부 사용자를 위한 도구를 빌드하는 파트너의 경우 다음과 같은 유사한 접근 방식을 사용하는 것이 좋습니다.
개발자 토큰의 관리자 계정에 액세스할 수 있는 사용자에 대해 설치된 애플리케이션 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 외부 고객별로 Google Ads 계정을 만들고 관리자 계정에 연결합니다. 그런 다음 고객이 계획을 생성할 때 해당 고객 ID를 제공하도록 도구를 구성합니다.
사용자가 웹 애플리케이션 흐름을 사용하여 도구에 계정 액세스 권한을 부여할 수 있도록 합니다. 사용자가 권한을 부여하면 CustomerService를 사용하여 액세스할 수 있는 Google Ads 계정 목록을 제공합니다.
목표는 플래너가 ReachPlanService를 사용할 때 최대한 원활하게 사용할 수 있도록 하는 것입니다. API를 통합하기 전에 상황에 따라 두 가지 접근 방식 중 하나를 선택하고 테스트할 고객 ID를 몇 개 식별하세요. 잘 모르겠다면 도구 유형에 대해 제안된 첫 번째 방법을 사용하세요.
[null,null,["최종 업데이트: 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."]]
