Żądania wysyłane do ReachPlanService muszą zawierać dane uwierzytelniające OAuth i identyfikator klienta, do którego te dane mają dostęp. Dodatkowo projekt w chmurze Google powiązany z Twoimi danymi logowania OAuth musi zostać zatwierdzony do korzystania z tej usługi.
Ten przewodnik zawiera szczegółowe informacje o uwierzytelnianiu w ReachPlanService. Jeśli jeszcze nie masz za sobą kroków opisanych w artykule Pierwsze kroki, wykonaj je, a następnie wróć do tego przewodnika.
Dane logowania OAuth
Oprócz wskazówek podanych w sekcji 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 został on już zatwierdzony do używania 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 klienta możesz wysyłać zapytania w
ReachPlanService. Te informacje są przydatne podczas integracji i zostały 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 do identyfikacji konta docelowego, jak i danych logowania OAuth uprawnionych do dostępu do tego identyfikatora klienta.
Jednak ReachPlanService służy do planowania działań związanych z filmami, które mogą mieć miejsce przed utworzeniem konkretnego konta klienta na potrzeby prowadzenia kampanii.
Narzędzia wewnętrzne
Jeśli tworzysz narzędzia do użytku wewnętrznego w organizacji, rozważ te opcje:
- Planujący bez bezpośredniego dostępu do konta klienta: jeśli Twoi planujący nie mają dostępu do kont Google Ads Twoich klientów, wygeneruj dane logowania OAuth, korzystając z procesu uwierzytelniania pojedynczego użytkownika, dla 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. Podczas wysyłania żądań do
ReachPlanServicepodaj 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 Twoich 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 abonamentowi klienta.
Narzędzia zewnętrzne
Jeśli tworzysz narzędzia dla użytkowników zewnętrznych, zalecamy te opcje:
- Konta poszczególnych klientów: wygeneruj dane logowania OAuth, korzystając z procesu uwierzytelniania pojedynczego użytkownika, dla użytkownika z dostępem 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 przyznawanie narzędziu dostępu do ich kont za pomocą procesu uwierzytelniania wielu użytkowników. Gdy użytkownik udzieli uprawnień, użyj metody
CustomerService, aby pobrać listę kont Google Ads, do których ma on dostęp.
Przed integracją interfejsu API wybierz jedno z powyższych podejść na podstawie wymagań systemowych i określ kilka identyfikatorów klientów do testów. W razie wątpliwości zacznij od procesu uwierzytelniania pojedynczego użytkownika z połączonymi kontami.
Co dalej?
Dowiedz się, jak określić media plan.