Authentication

Żą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 nie masz jeszcze konta, 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:

  1. Aby połączyć się z ReachPlanService, musisz dodać swój token programisty do 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.
  2. Aby połączyć się z interfejsem Google Ads API, musisz zaakceptować Warunki korzystania z interfejsu Google Ads API.
  3. 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 opisane poniżej.

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. Jednak ReachPlanService jest 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ę.

Partnerom, którzy tworzą narzędzia do użytku wewnętrznego w swojej organizacji, zalecamy jedną z tych opcji:

  1. Jeśli Twoi planiści nie mają dostępu do kont Google Ads klientów: wygeneruj dane logowania OAuth za pomocą procesu aplikacji zainstalowanej dla użytkownika z dostępem 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.

  2. Jeśli Twoi planiści mają dostęp do konta menedżera Google Ads, które zarządza kontami klientów: zaimplementuj 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.

Partnerom, którzy tworzą narzędzie dla użytkowników zewnętrznych, zalecamy podobne podejście:

  1. Wygeneruj dane logowania OAuth za pomocą procesu aplikacji zainstalowanej 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.

  2. 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.

Wstecz
Pojęcia
Dalej
Określanie media planu