Żądania wysyłane do ReachPlanService
muszą zawierać zatwierdzony token programisty, dane logowania OAuth oraz identyfikator klienta, do którego mają dostęp Twoje dane logowania OAuth.
W tym przewodniku omawiamy szczegóły uwierzytelniania ReachPlanService
. Jeśli jeszcze nie zostało to zrobione, wykonaj czynności opisane w sekcji Rozpocznij, a potem wróć do tego kroku.
Token programisty i dane logowania OAuth
Oprócz wskazówek zawartych w sekcji Rozpocznij pamiętaj o tych kwestiach:
- Token programisty musi znajdować się na liście dozwolonych, aby możliwe było połączenie z
ReachPlanService
, nawet jeśli został 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 będący właścicielem tokena odświeżania OAuth określa, do których identyfikatorów klientów możesz wysyłać zapytania w
ReachPlanService
. Informuje o tym integrację, co zostało wyjaśnione w dalszej części artykułu.
ID klientów
Większość usług w ramach interfejsu 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 wysyłania zapytań, jak i danych logowania OAuth, które mają uprawnienia dostępu do tego identyfikatora klienta. Parametr ReachPlanService
jest jednak przeznaczony do działań związanych z planowaniem reklam wideo, które mogą wystąpić, zanim poznasz konkretny identyfikator klienta, na którym uruchomisz kampanię.
Partnerzy, którzy tworzą narzędzia do użytku wewnętrznego w organizacji, zalecamy korzystanie z jednej z tych opcji:
Jeśli planerzy nie mają dostępu do kont Google Ads Twoich klientów: wygeneruj dane logowania OAuth, korzystając z instalacji aplikacji dla użytkownika z dostępem do konta menedżera z Twoim tokenem 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 ze swoim kontem menedżera. Przesyłając żądania do
ReachPlanService
, podaj identyfikator klienta odpowiadający zespołowi użytkownika.Jeśli planerzy mają dostęp do konta menedżera Google Ads, które zarządza kontami Twoich klientów: zaimplementuj proces aplikacji internetowej, aby zezwolić aplikacji na korzystanie z danych logowania OAuth organizatora. Następnie możesz przekazać identyfikator klienta odpowiadający klientowi objętemu abonamentem.
Partnerzy, którzy tworzą narzędzie dla użytkowników zewnętrznych, powinni stosować podobne metody:
Wygeneruj dane logowania OAuth, korzystając z procesu instalacji aplikacji dla użytkownika z dostępem do konta menedżera z Twoim tokenem programisty. Utwórz konto Google Ads dla klienta zewnętrznego i połącz go z kontem menedżera. Następnie skonfiguruj narzędzie, aby podawać odpowiedni identyfikator klienta podczas generowania abonamentów.
Daj użytkownikom możliwość przyznawania Twojemu narzędziu dostępu do ich kont, korzystając z przepływu aplikacji internetowej. Gdy użytkownik udzieli Ci odpowiednich uprawnień, użyj narzędzia
CustomerService
, aby podać mu listę kont Google Ads, do których ma dostęp.
Dzięki temu planerzy podczas korzystania z ReachPlanService
będą mieli jak najmniej kłopotów. Zanim zintegrujesz interfejs API, wybierz w zależności od sytuacji 1 z 2 metod i wskaż kilka identyfikatorów klienta do przetestowania. W razie wątpliwości zastosuj pierwszy sugerowany sposób.