Interfejs API Search Ads 360 wymaga, aby we wszystkich żądaniach podać token dostępu OAuth 2.0 na potrzeby uwierzytelniania. Aby wygenerować token i przekazać go do interfejsu Search Ads 360 API, możesz wykonać standardową procedurę uwierzytelniania OAuth 2.0. Zalecamy stosowanie opisanego poniżej przepływu pracy, ponieważ jest on odpowiedni do w pełni zautomatyzowanego przesyłania konwersji i pobierania raportów.
Alternatywy dla przepływu pracy opisanego poniżej znajdziesz w artykułach Używanie protokołu OAuth 2.0 w zainstalowanych aplikacjach i
Używanie OAuth 2.0 w aplikacjach między serwerami. Jeśli korzystasz z innego przepływu pracy, podaj tę wartość jako parametr scope podczas żądania kodu autoryzacji OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Jeśli korzystasz z trasy serwer-serwer, dodaj konto usługi jako użytkownik Search Ads 360.
Zalecany przepływ pracy autoryzacji
- Otwórz Konsolę interfejsów API Google i wybierz projekt.
Jeśli nie masz jeszcze projektu w Konsoli interfejsów API Google ani danych logowania OAuth, wykonaj instrukcje w artykule Tworzenie projektu w Konsoli interfejsów API Google i danych logowania OAuth dla klienta.
Aby znaleźć identyfikator i klucz tajny klienta OAuth projektu, wykonaj te czynności:
- Otwórz stronę Dane logowania.
- W kolumnie Nazwa kliknij nazwę klienta OAuth.
- Identyfikator klienta i obiekt tajny zostaną wyświetlone na stronie.
- Otwórz przeglądarkę i zaloguj się w Google
na konto Google, które ma uprawnienia do uzyskiwania dostępu do danych w Search Ads 360.
To konto Google, którego klient interfejsu API użyje do uwierzytelnienia w Search Ads 360. Jeśli właściciel konta Google odejdzie z Twojej firmy i odłączysz Search Ads 360 od tego konta, musisz powtórzyć ten proces autoryzacji i podać inne konto Google.
- Aby uzyskać token odświeżania, wywołaj skrypt narzędziowy Search Ads 360 w ten sposób:
sa360Api.py --loginSkrypt przeprowadzi Cię przez proces uzyskiwania tokena odświeżania za pomocą identyfikatora i klucza klienta OAuth. Token odświeżania jest ważny tylko dla konta Google, na które zalogowano się w poprzednim kroku.
W ramach tego procesu skrypt generuje adres URL i prosi o odwiedzenie go w przeglądarce.
-
Gdy przeglądarka poprosi o zezwolenie na dostęp klienta OAuth do danych Search Ads 360, sprawdź, czy wyświetla się konto Google, na które się wcześniej zalogowałeś(-aś). (jeśli logujesz się na wiele kont Google, może zostać wyświetlone inne konto).
Na końcu procesu skrypt
sa360Api.pyzwraca ciąg znaków oddzielony przecinkami. Pierwsza wartość to podany przez Ciebie identyfikator klienta, druga – podany przez Ciebie tajny klucz klienta, a trzecia – token odświeżania. W tym przykładowym wyjściu token odświeżania jest oznaczony pogrubieniem:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw - Przechowuj identyfikator klienta, tajny klucz klienta oraz token odświeżania w bazie danych backendu lub innej bezpiecznej lokalizacji, do której dostęp jest dostępny dla Twojej aplikacji.
Jeśli planujesz używać
sa360Api.pydo wysyłania przykładowych żądań JSON do interfejsu Search Ads 360 API, przechowuj cały ciąg oddzielony przecinkami w dogodnym miejscu. Za każdym razem, gdy wywołujesz skrypt, przekazujesz cały ciąg znaków jako parametr. - Dodaj do aplikacji kod, który:
- Użyj identyfikatora klienta, tajnego klucza klienta i tokena odświeżania, aby uzyskać nowy token dostępu OAuth 2.0.
- Wysyłaj żądania do interfejsu Search Ads 360 API, korzystając z nowego tokena dostępu.
Jeśli korzystasz z bibliotek klienta, w następnej sekcji Konfigurowanie aplikacji znajdziesz informacje o dodawaniu tego kodu autoryzacji do aplikacji.
Jeśli nie używasz żadnej z bibliotek klienta, zapoznaj się z artykułem Używanie protokołu OAuth 2.0 w zainstalowanych aplikacjach, w którym znajdziesz sugestie, jak uzyskać nowy token dostępu.