30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

Skonfiguruj autoryzację

Interfejs Search Ads 360 API wymaga od wszystkich żądań określenia tokena dostępu OAuth 2.0 do uwierzytelniania. Aby wygenerować token i przekazać go do interfejsu Search Ads 360 API, możesz wykonać dowolny standardowy proces uwierzytelniania OAuth 2.0. Zalecamy skorzystanie z opisanego poniżej procesu, ponieważ jest on odpowiedni do automatycznego przesyłania konwersji i pobierania raportów.

Informacje o alternatywnych przepływach pracy opisanych poniżej znajdziesz w artykułach Używanie OAuth 2.0 w przypadku zainstalowanych aplikacji i Używanie protokołu OAuth 2.0 w aplikacjach międzyserwerowych. Jeśli korzystasz z innego przepływu pracy, podaj tę wartość jako parametr scope w przypadku żądania kodu autoryzacji OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
W przypadku śledzenia serwera na serwer dodaj konto usługi jako użytkownika Search Ads 360.

Zalecany przepływ autoryzacji

Otwórz Konsolę interfejsów API Google i wybierz projekt.
Jeśli nie masz jeszcze utworzonego projektu konsoli interfejsu API Google ani danych logowania OAuth, wykonaj czynności opisane w artykule Tworzenie projektu w konsoli Google API i danych logowania OAuth do klienta.

Aby znaleźć identyfikator i klucz klienta OAuth projektu, wykonaj te czynności:
1. Otwórz stronę Dane logowania.
2. W kolumnie Nazwa kliknij nazwę klienta OAuth.
3. Na stronie znajduje się identyfikator klienta i tajny klucz klienta.
Otwórz przeglądarkę i zaloguj się w Google za pomocą konta Google, które ma uprawnienia dostępu do danych w Search Ads 360.
To konto Google będzie używane przez klienta interfejsu API do uwierzytelniania w Search Ads 360. Jeśli właściciel konta Google odejdzie z firmy i usuniesz z niego dostęp do Search Ads 360, będzie trzeba powtórzyć proces autoryzacji i wybrać inne konto Google.
Uzyskaj token odświeżania, wywołując skrypt narzędzia Search Ads 360 w ten sposób:
sa360Api.py --login

Skrypt przedstawia proces korzystania z identyfikatora klienta i tajnego klucza Oauth w celu uzyskania tokena odświeżania. Token odświeżania dotyczy tylko konta Google, na które zalogowałeś się w poprzednim kroku.
W ramach tego procesu skrypt generuje adres URL i wyświetla w przeglądarce prośbę o otwarcie adresu URL.
Gdy przeglądarka poprosi o zgodę klienta OAuth na dostęp do danych Search Ads 360, sprawdź, czy konto Google, na które się zalogowałeś, jest widoczne. Jeśli zalogujesz się na wiele kont Google, może pojawić się inne konto.

Po zakończeniu tego procesu skrypt sa360Api.py zwróci ciąg rozdzielany przecinkami. Pierwsza wartość to podany identyfikator klienta, druga wartość to tajny klucz klienta, a trzecia to token odświeżania. W tym przykładowym pliku danych token odświeżania jest pogrubiony:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
Zapisz identyfikator klienta, tajny klucz klienta i token odświeżania w bazie danych backendu lub innej bezpiecznej lokalizacji, która jest dostępna dla Twojej aplikacji.
Zachowaj cały ciąg rozdzielany przecinkami w wygodnej lokalizacji, jeśli zamierzasz używać sa360Api.py do wysyłania przykładowych żądań JSON do interfejsu Search Ads 360 API. Za każdym razem, gdy wywołujesz skrypt, przekazujesz cały parametr jako parametr.
Dodaj do aplikacji kod wykonujący te czynności:
1. Użyj identyfikatora klienta, tajnego klucza klienta i tokena odświeżania, aby uzyskać nowy token dostępu OAuth 2.0.
2. Wysyłaj żądania do interfejsu Search Ads 360 API za pomocą nowego tokena dostępu.
Jeśli używasz bibliotek klienta, w następnej sekcji Konfigurowanie aplikacji opisujemy, jak dodać ten kod autoryzacji do aplikacji.

Jeśli nie używasz żadnej z bibliotek klienta, zapoznaj się z sugestiami na temat uzyskiwania nowego tokena dostępu przy użyciu OAuth 2.0 dla zainstalowanych aplikacji.