Żądania wysyłane do ReachPlanService muszą
zawierać dane logowania OAuth i identyfikator klienta, do którego mają dostęp te dane logowania. Poza tym projekt w chmurze Google Cloud, do którego należą dane logowania protokołu OAuth, powinien być zatwierdzony do korzystania z tej usługi.
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.
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ć numer projektu Google Cloud do odpowiedniej listy dozwolonych , nawet jeśli projekt jest 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.
Identyfikatory 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
zarządzane lub wysyłane zapytanie, jak i danych logowania OAuth, które mają uprawnienia dostępu do tego
identyfikatora klienta. Jednak ReachPlanService
jest przeznaczony 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.
Planujący bez bezpośredniego dostępu do konta klienta
Jeśli Twoi planujący nie mają dostępu do kont Google Ads klientów,
wygeneruj dane logowania OAuth za pomocą procesu uwierzytelniania pojedynczego użytkownika
, który ma dostęp do
Twojego konta menedżera. 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.
W przypadku żądań wysyłanych do ReachPlanService
podaj identyfikator klienta odpowiadający zespołowi użytkownika.
Planujący z dostępem do konta klienta
Jeśli Twoi planujący 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 planujących. 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 klientów
Wygeneruj dane logowania OAuth za pomocą procesu uwierzytelniania pojedynczego użytkownika flow, który ma dostęp do Twojego konta menedżera. 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 podać
mu listę kont Google Ads, do których ma dostęp.
Chcemy, aby planujący 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 danego typu narzędzia.
Co dalej?
Dowiedz się, jak określić plan mediowy.