Żądania wysyłane do ReachPlanService muszą
zawierać zatwierdzony token programisty, dane logowania OAuth i identyfikator klienta, do którego
mają dostęp dane logowania OAuth.
W tym przewodniku znajdziesz informacje o uwierzytelnianiu w
ReachPlanService. Jeśli jeszcze tego nie zrobisz,
najpierw wykonaj czynności opisane w artykule Pierwsze
kroki, a potem wróć do tego miejsca.
Token programisty i dane logowania OAuth
Oprócz wskazówek podanych w artykule Pierwsze kroki pamiętaj o tych kwestiach:
- Aby połączyć się
z
ReachPlanService, musisz dodać token programisty do odpowiedniej listy dozwolonych, nawet jeśli jest on już zatwierdzony do użycia z innymi usługami interfejsu Google Ads API. Więcej informacji znajdziesz w sekcji Wymagania kwalifikacyjne. - 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, które identyfikatory klientów możesz
wysyłać w zapytaniach do
ReachPlanService. Ma to wpływ na integrację i jest 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. Dlatego większość żądań wymaga zarówno identyfikatora klienta, który identyfikuje
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. Usługa ReachPlanService
jest jednak przeznaczona do planowania działań związanych z reklamami wideo, które mogą mieć miejsce, zanim poznasz
konkretny identyfikator klienta, w którym chcesz prowadzić kampanię.
Narzędzia wewnętrzne
Jeśli tworzysz narzędzia do użytku wewnętrznego w swojej organizacji, zapoznaj się z naszymi rekomendacjami.
Planerzy bez bezpośredniego dostępu do konta klienta
Jeśli Twoi planerzy nie mają dostępu do kont Google Ads klientów,
wygeneruj dane logowania OAuth za pomocą procesu uwierzytelniania pojedynczego użytkownika
dla użytkownika, który ma dostęp do
konta menedżera tokena 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 planerzy mają dostęp do konta menedżera Google Ads, które zarządza kontami klientów, zaimplementuj proces uwierzytelniania wielu użytkowników aby umożliwić aplikacji korzystanie z danych logowania OAuth planerów. Następnie możesz przekazać identyfikator klienta odpowiadający klientowi Twojego planu.
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 uwierzytelniania pojedynczego użytkownikadla użytkownika, który ma dostęp do konta menedżera tokena programisty. 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żliw użytkownikom przyznawanie Twojemu narzędziu dostępu do ich kont
za pomocą procesu 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.
Celem jest zapewnienie, aby planerzy mieli jak najmniej problemów z korzystaniem z
ReachPlanService. Zanim zintegrujesz interfejs API, wybierz jedną z tych 2 metod w zależności od sytuacji i określ kilka identyfikatorów klientów do przetestowania. Jeśli masz wątpliwości, użyj pierwszej sugerowanej metody dla swojego typu narzędzia.
Co dalej?
Dowiedz się, jak określić plan mediowy.