Authentication

Żądania wysyłane do ReachPlanService muszą zawierać dane logowania OAuth i identyfikator klienta, do którego mają dostęp te dane. Dodatkowo projekt w chmurze Google Cloud powiązany z Twoimi danymi logowania protokołu OAuth musi 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 przewodniku Pierwsze kroki, a potem wróć do tego przewodnika.

Dane logowania OAuth

Oprócz wskazówek podanych w przewodniku Pierwsze kroki pamiętaj o tych kwestiach:

  1. Numer Twojego projektu Google Cloud musi zostać dodany do odpowiedniej listy dozwolonych aby można było połączyć się z ReachPlanService, 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 dotyczące kwalifikacji.
  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, 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 klienta

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 docelowe i danych logowania OAuth uprawnionych do 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 przed utworzeniem konkretnego konta klienta do prowadzenia kampanii.

Narzędzia wewnętrzne

Jeśli tworzysz narzędzia do użytku wewnętrznego w swojej organizacji, rozważ te opcje:

  • 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, który ma dostęp do Twojego konta menedżera. Następnie utwórz lub uzyskaj konto Google Ads dla każdego zespołu korzystającego z Twojego narzędzia i połącz je z kontem menedżera account. W przypadku żądań wysyłanych 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 planowi klienta.

Narzędzia zewnętrzne

Jeśli tworzysz narzędzia dla użytkowników zewnętrznych, zalecamy te opcje:

  • Konta klientów: wygeneruj dane logowania OAuth za pomocą procesu uwierzytelniania pojedynczego użytkownika, 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. Skonfiguruj narzędzie tak, aby podczas generowania planów podawało odpowiedni identyfikator klienta.
  • Dostęp przyznany przez użytkownika: zezwól użytkownikom na przyznanie Twojemu narzędziu dostępu do ich kont za pomocą procesu uwierzytelniania wielu użytkowników flow. Gdy użytkownik przyzna uprawnienia, użyj CustomerService, aby pobrać listę kont Google Ads , do których ma dostęp.

Zanim zintegrujesz interfejs API, wybierz jedną z opisanych powyżej metod na podstawie wymagań systemowych i określ kilka testowych identyfikatorów klientów. Jeśli masz wątpliwości, zacznij od procesu uwierzytelniania pojedynczego użytkownika z połączonymi kontami.

Co dalej?

Dowiedz się, jak określić plan mediowy.