Żą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 jeszcze tego nie zrobisz, 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 dewelopera do odpowiedniej 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 wyjaśnione w sekcjach poniżej.
ID klientów
Większość usług w interfejsie Google Ads API działa na określonych kontach i kampaniach Google Ads. Dlatego większość żądań wymaga zarówno identyfikatora klienta, aby zidentyfikować konto, którym zarządzasz lub o które pytasz, jak i danych logowania OAuth, które mają uprawnienia dostępu do tego identyfikatora klienta. ReachPlanService
jest jednak 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ę.
Narzędzia wewnętrzne
Jeśli tworzysz narzędzia do użytku wewnętrznego w swojej organizacji, zapoznaj się z naszymi zaleceniami.
Planujący bez bezpośredniego dostępu do konta klienta
Jeśli Twoi planiści nie mają dostępu do kont Google Ads klientów, wygeneruj dane logowania OAuth za pomocą procesu instalacji aplikacji dla użytkownika, który ma dostęp 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.
Planerzy z dostępem do konta klienta
Jeśli Twoi planiści mają dostęp do konta menedżera Google Ads, które zarządza kontami klientów, wdróż 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.
Narzędzia zewnętrzne
Jeśli tworzysz narzędzie dla użytkowników zewnętrznych, zalecamy podobne podejście:
Konta poszczególnych klientów
Wygeneruj dane logowania OAuth za pomocą procesu instalacji aplikacji 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.
Dostęp przyznany przez użytkownika
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.
Co dalej?
Dowiedz się, jak określić media plan.