Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Các yêu cầu đối với ReachPlanService phải cung cấp mã thông báo nhà phát triển đã được phê duyệt, thông tin đăng nhập OAuth và mã khách hàng mà thông tin đăng nhập OAuth của bạn có thể truy cập.
Hướng dẫn này trình bày chi tiết về quy trình xác thực dành riêng cho ReachPlanService. Nếu bạn chưa thực hiện, trước tiên hãy hoàn tất các bước được nêu trong phần Bắt đầu, sau đó quay lại bước này.
Mã thông báo nhà phát triển và thông tin đăng nhập OAuth
Ngoài hướng dẫn trong phần Bắt đầu, hãy lưu ý những điểm sau:
Bạn phải đưa mã thông báo của nhà phát triển vào danh sách cho phép để kết nối với ReachPlanService, ngay cả khi mã thông báo đó đã được phê duyệt để sử dụng với các dịch vụ khác của API Google Ads. Để biết thêm thông tin, hãy xem các yêu cầu về điều kiện sử dụng.
Bạn phải chấp nhận Điều khoản dịch vụ của API Google Ads để kết nối với API Google Ads.
Người dùng sở hữu mã làm mới OAuth của bạn sẽ xác định những mã khách hàng mà bạn có thể truy vấn trong ReachPlanService.
Điều này sẽ giúp bạn biết được cách tích hợp và được giải thích chi tiết hơn bên dưới.
ID Khách hàng
Hầu hết các dịch vụ trong API Google Ads đều hoạt động trên các tài khoản và chiến dịch cụ thể trên Google Ads. Do đó, hầu hết các yêu cầu đều cần cả mã khách hàng để xác định tài khoản mà bạn đang quản lý hoặc truy vấn, và thông tin xác thực OAuth có quyền truy cập vào mã khách hàng đó. Tuy nhiên, ReachPlanService được dùng cho các hoạt động lập kế hoạch video có thể diễn ra trước khi bạn biết mã khách hàng cụ thể mà bạn sẽ chạy chiến dịch.
Đối với những đối tác tạo công cụ để sử dụng nội bộ trong tổ chức của họ, chúng tôi đề xuất một trong những lựa chọn sau:
Nếu người lập kế hoạch không có quyền truy cập vào tài khoản Google Ads của khách hàng: Tạo thông tin đăng nhập OAuth bằng quy trình ứng dụng đã cài đặt cho người dùng có quyền truy cập vào tài khoản người quản lý mã thông báo nhà phát triển của bạn. Sau đó, hãy tạo hoặc lấy một tài khoản Google Ads cho mỗi nhóm sử dụng công cụ của bạn và liên kết các tài khoản đó với tài khoản người quản lý của bạn. Khi đưa ra yêu cầu đối với ReachPlanService, hãy cung cấp mã khách hàng tương ứng với nhóm của người dùng.
Nếu các nhà lập kế hoạch của bạn có quyền truy cập vào một tài khoản người quản lý Google Ads để quản lý tài khoản của khách hàng: Triển khai quy trình ứng dụng web để cho phép ứng dụng của bạn sử dụng thông tin đăng nhập OAuth của nhà lập kế hoạch. Sau đó, bạn có thể truyền mã nhận dạng khách hàng tương ứng với khách hàng của gói.
Đối với những đối tác xây dựng một công cụ cho người dùng bên ngoài, bạn nên áp dụng các phương pháp tương tự:
Tạo thông tin đăng nhập OAuth bằng quy trình ứng dụng đã cài đặt cho người dùng có quyền truy cập vào tài khoản người quản lý mã thông báo nhà phát triển của bạn. Tạo một tài khoản Google Ads cho mỗi khách hàng bên ngoài và liên kết các tài khoản đó với tài khoản người quản lý. Sau đó, hãy định cấu hình công cụ để cung cấp mã khách hàng tương ứng của khách hàng khi họ tạo kế hoạch.
Cho phép người dùng cấp quyền truy cập vào tài khoản của họ cho công cụ của bạn bằng cách sử dụng quy trình ứng dụng web. Sau khi người dùng cấp quyền, hãy sử dụng CustomerService để cung cấp cho họ danh sách tài khoản Google Ads mà họ có thể truy cập.
Mục tiêu là đảm bảo người lập kế hoạch có thể sử dụng ReachPlanService một cách dễ dàng nhất có thể. Trước khi tích hợp API, hãy chọn một trong hai phương pháp tuỳ theo tình huống của bạn và xác định một vài mã nhận dạng khách hàng để kiểm thử. Nếu không chắc chắn, hãy sử dụng phương pháp được đề xuất đầu tiên cho loại công cụ của bạn.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
