Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Żądania wysyłane do ReachPlanService muszą zawierać zatwierdzony token dewelopera, dane logowania OAuth i identyfikator klienta, do którego Twoje dane logowania OAuth mają dostęp.
Ten przewodnik zawiera szczegółowe informacje o uwierzytelnianiu w przypadku ReachPlanService. Jeśli nie masz jeszcze konta, najpierw wykonaj czynności opisane w sekcji Pierwsze kroki, a potem wróć do tego miejsca.
Token programisty i dane logowania OAuth
Oprócz wskazówek podanych w sekcji Rozpoczęcie pamiętaj o tych kwestiach:
Aby połączyć się z ReachPlanService, musisz dodać swój token programisty do listy dozwolonych, nawet jeśli został on już zatwierdzony do użytku z innymi usługami interfejsu Google Ads API. Więcej informacji znajdziesz w wymaganiach.
Aby połączyć się z interfejsem Google Ads API, musisz zaakceptować Warunki korzystania z interfejsu Google Ads API.
Użytkownik, który jest właścicielem tokena odświeżania OAuth, określa, o które identyfikatory klientów możesz wysyłać zapytania w usłudze ReachPlanService.
Ma to wpływ na integrację i jest szczegółowo opisane poniżej.
ID klientów
Większość usług w interfejsie Google Ads API działa na określonych kontach i kampaniach Google Ads. W związku z tym większość żądań wymaga zarówno identyfikatora klienta, aby zidentyfikować konto, którym zarządzasz lub o które wysyłasz zapytanie, jak i danych logowania OAuth, które mają uprawnienia dostępu do tego identyfikatora klienta. Jednak ReachPlanService
jest przeznaczony do planowania działań związanych z filmami, które mogą mieć miejsce, zanim poznasz
konkretny identyfikator klienta, na którym chcesz uruchomić kampanię.
Partnerom, którzy tworzą narzędzia do użytku wewnętrznego w swojej organizacji, zalecamy jedną z tych opcji:
Jeśli Twoi planiści nie mają dostępu do kont Google Ads klientów:
wygeneruj dane logowania OAuth za pomocą procesu aplikacji zainstalowanej dla użytkownika
z dostępem do konta menedżera tokenu programisty. Następnie utwórz lub uzyskaj konto Google Ads dla każdego zespołu, który korzysta z Twojego narzędzia, i połącz je z kontem menedżera. Podczas wysyłania żądań do ReachPlanService podaj identyfikator klienta odpowiadający zespołowi użytkownika.
Jeśli Twoi planiści mają dostęp do konta menedżera Google Ads, które zarządza kontami klientów: zaimplementuj przepływ aplikacji internetowej, aby umożliwić aplikacji korzystanie z danych logowania OAuth Twoich planistów. Następnie możesz przekazać identyfikator klienta odpowiadający klientowi Twojego abonamentu.
Partnerom, którzy tworzą narzędzie dla użytkowników zewnętrznych, zalecamy podobne podejście:
Wygeneruj dane logowania OAuth za pomocą procesu aplikacji zainstalowanej dla użytkownika, który ma dostęp do konta menedżera tokena dewelopera. Utwórz konto Google Ads dla każdego klienta zewnętrznego i połącz je z kontem menedżera. Następnie skonfiguruj narzędzie tak, aby podczas generowania planów podawało odpowiedni identyfikator klienta.
Umożliwiaj użytkownikom przyznawanie Twojemu narzędziu dostępu do ich kont za pomocą procesu aplikacji internetowej. Gdy użytkownik przyzna uprawnienia, użyj CustomerService, aby wyświetlić listę kont Google Ads, do których ma dostęp.
Chcemy zapewnić planistom jak najmniejsze trudności podczas korzystania z ReachPlanService. Zanim zintegrujesz interfejs API, wybierz jedną z 2 metod odpowiednią dla Twojej sytuacji i określ kilka identyfikatorów klientów do przetestowania. W razie wątpliwości użyj pierwszej sugerowanej metody dla danego typu narzędzia.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 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."]]
