Żądania wysyłane do ReachPlanService muszą zawierać zatwierdzony token programisty, dane logowania OAuth i identyfikator klienta, do którego Twoje dane logowania OAuth mają dostęp.
Ten przewodnik zawiera informacje o danych uwierzytelniających specyficznych dla ReachPlanService. Jeśli jeszcze tego nie zrobisz, najpierw wykonaj czynności opisane w sekcji Rozpocznij, 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 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
ReachPlanService. Ma to wpływ na integrację i jest bardziej szczegółowo opisane w kolejnych sekcjach.
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. 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ą uwierzytelniania jednego użytkownika dla użytkownika, który ma dostęp do konta menedżera tokena dewelopera. 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óż proces uwierzytelniania wielu użytkowników, 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ą uwierzytelniania jednego użytkownika w przypadku użytkownika, który ma dostęp do konta menedżera tokena deweloperskiego. 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ą uwierzytelniania wielu użytkowników. 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ą do 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.