Żądania wysyłane do ReachPlanService muszą dostarczać zatwierdzony token programisty, dane logowania OAuth i identyfikator klienta, do których mają dostęp Twoje dane logowania OAuth.
W tym przewodniku omawiamy szczegóły uwierzytelniania związane z ReachPlanService. Najpierw wykonaj czynności opisane w artykule Pierwsze kroki, a potem wróć do tego punktu.
Token programisty i dane logowania OAuth
Oprócz wskazówek przedstawionych na stronie Pierwsze kroki pamiętaj o tych kwestiach:
- Twój token programisty musi znajdować się na liście dozwolonych, aby można było połączyć się z
ReachPlanService, nawet jeśli został już zatwierdzony do użycia z innymi usługami interfejsu Google Ads API. Więcej informacji znajdziesz w wymaganiach. - Aby utworzyć połączenie z tym interfejsem, musisz zaakceptować Warunki korzystania z interfejsu Google Ads API.
- Użytkownik, który jest właścicielem tokena odświeżania OAuth, decyduje o tym, o które identyfikatory klienta możesz wysyłać zapytania w
ReachPlanService. Wpływa to na Twoją integrację i zostało szczegółowo wyjaśnione poniżej.
ID klientów
Większość usług w ramach interfejsu Google Ads API działa na określonych kontach i w określonych kampaniach Google Ads. W związku z tym większość żądań wymaga identyfikatora klienta w celu identyfikacji konta, którym zarządzasz lub którego dotyczy zapytanie, oraz danych logowania OAuth z uprawnieniami dostępu do tego identyfikatora klienta. Jednak ReachPlanService jest przeznaczony do planowania kampanii wideo, które mogą mieć miejsce, zanim poznasz identyfikator klienta, dla którego chcesz uruchomić kampanię.
Partnerom, którzy tworzą narzędzia do użytku wewnętrznego w organizacji, zalecamy jedną z tych opcji:
Jeśli Twoi planerzy nie mają dostępu do kont Google Ads Twoich klientów: za pomocą procesu zainstalowanej aplikacji wygeneruj dane logowania OAuth dla użytkownika z dostępem do konta menedżera tokena dewelopera. Następnie utwórz lub uzyskaj konto Google Ads dla każdego zespołu, który używa Twojego narzędzia, i połącz je ze swoim kontem menedżera. Wysyłając żądania do
ReachPlanService, podawaj 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 klientów: zaimplementuj proces aplikacji internetowej, aby umożliwić aplikacji używanie danych logowania OAuth plannerów. Następnie możesz przekazać identyfikator klienta odpowiadający klientowi korzystającemu z Twojego abonamentu.
Partnerom, którzy tworzą narzędzie dla użytkowników zewnętrznych, zalecamy skorzystanie z podobnych metod:
Korzystając z procesu zainstalowanej aplikacji, możesz generować dane logowania OAuth dla użytkownika z dostępem do konta menedżera Twojego tokena dewelopera. Utwórz konto Google Ads dla klienta zewnętrznego i połącz go ze swoim kontem menedżera. Następnie skonfiguruj narzędzie, aby podawał odpowiedni identyfikator klienta podczas generowania planów.
Zapewnij użytkownikom możliwość przyznania Twojemu narzędziu dostępu do ich kont, korzystając z procedury internetowej. Gdy użytkownik przyzna uprawnienia, użyj pola
CustomerService, aby udostępnić mu listę kont Google Ads, do których ma dostęp.
Dzięki temu chcemy zadbać o to, aby korzystanie z ReachPlanService było dla planerów możliwie jak najprostsze. Przed integracją interfejsu API wybierz jedną z dwóch metod w zależności od sytuacji i wskaż kilka identyfikatorów klienta do przetestowania. W razie wątpliwości zastosuj pierwszą
sugerowaną metodę dla Twojego typu narzędzia.