Autoryzacja konfiguracji
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 --login
Skrypt 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.py zwraca 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.py do 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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-11-07 UTC.
[null,null,["Ostatnia aktualizacja: 2024-11-07 UTC."],[[["\u003cp\u003eThe Search Ads 360 API requires OAuth 2.0 access tokens for authentication, obtainable through standard OAuth 2.0 workflows or the recommended workflow outlined in the document.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended workflow involves obtaining a refresh token using the provided utility script and storing it securely along with the client ID and secret.\u003c/p\u003e\n"],["\u003cp\u003eApplications should be designed to use the stored credentials to obtain fresh access tokens for API requests, as detailed in the "Set Up Your Application" section or relevant OAuth 2.0 documentation.\u003c/p\u003e\n"],["\u003cp\u003eAlternative workflows for installed or server-to-server applications are available with specific scope requirements and user management considerations.\u003c/p\u003e\n"]]],["The Search Ads 360 API requires OAuth 2.0 access tokens for authentication. The recommended workflow involves creating a Google API Console project and obtaining OAuth credentials. Users sign into a Google Account with Search Ads 360 access, then use the `sa360Api.py` script to generate a refresh token. The script outputs client ID, client secret, and refresh token. Store these securely, and use them in your application to obtain a fresh OAuth access token for API requests.\n"],null,["# Set Up Authorization\n\nThe Search Ads 360 API requires all requests to specify an [OAuth 2.0](/accounts/docs/OAuth2)\naccess token for authentication. You can follow any standard OAuth 2.0 authentication workflow\nto generate the token and pass it to the Search Ads 360 API. We recommend the workflow described\nbelow because it is suitable for fully automated conversion uploads and report downloads.\n\n\nFor alternatives to the workflow described below, see [Using\nOAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) or\n[Using OAuth 2.0 for Server to Server Applications](https://developers.google.com/identity/protocols/OAuth2ServiceAccount). If you use an alternate workflow,\nspecify the following value as the `scope` parameter when you request an OAuth\n2.0 authorization code: \n\n`https://www.googleapis.com/auth/doubleclicksearch`\n\nIf you follow the server to server route, add the service account as a Search Ads 360 user.\n\nRecommended authorization workflow\n----------------------------------\n\n1. Go to the [Google API Console](https://console.cloud.google.com/) and select your project.\n\n\n If you haven't already created a Google API Console project and OAuth credentials, follow\n the instructions in [Create a Google API\n Console project and OAuth credentials for your client](/search-ads/v2/prereqs#project).\n\n To find your project's OAuth client ID and secret, do the following:\n 1. Open the [Credentials page](https://console.cloud.google.com/apis/credentials).\n 2. In the **Name** column, click the name of your OAuth client.\n 3. The client ID and secret are listed on the page.\n2. Open a web browser and [sign into Google](https://accounts.google.com/ServiceLogin)with a Google Account that [has\n permission to access data](/search-ads/v2/prereqs#permissions) in Search Ads 360.\n\n This is the Google Account your API client will use to authenticate with Search Ads 360.\n If the Google Account holder leaves your company and you remove Search Ads 360 access\n from the account, you will need to repeat this authorization workflow and specify a\n different Google Account.\n3. Obtain a refresh token by invoking the [Search Ads 360 utility script](/search-ads/v2/prereqs#ds3py) as follows:\n\n\n `sa360Api.py --login`\n\n\n The script takes you through the process of using the Oauth client ID and secret to\n obtain a refresh token. The refresh token is valid only for the Google Account you signed\n into during the previous step.\n\n As part of this process, the script generates a URL and instructs you to\n visit the URL in a web browser.\n4. When the browser asks you to allow OAuth client access to Search Ads 360 data,\n make sure the Google Account you signed into earlier appears. (If you're signed into multiple\n Google Accounts, you might be presented with a different account.)\n\n\n At the end of the process, the `sa360Api.py` script outputs a comma-delimited\n string. The first value is the client ID you provided, the second value is the client\n secret you provided, and the third value is the refresh token. In the following example\n output, the refresh token is in **bold text** : \n\n `123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,`**1/HIJklM01OPQR23NOP456rst890uvw**\n5. Store the client ID, client secret, and refresh token in a backend database or other secure location that's accessible to your application.\n Keep the entire comma-delimited string in a convenient location if you plan to use\n `sa360Api.py` to send sample JSON requests to the Search Ads 360 API. You'll pass the\n entire string as a parameter each time you invoke the script.\n\n6. Add code to your application that does the following:\n 1. Use the client ID, client secret, and refresh token to obtain a fresh OAuth 2.0 access token.\n 2. Send requests to the Search Ads 360 API using the fresh access token.\n\n\n If you're using the client libraries, the next section, [Set Up Your Application](/search-ads/v2/configure),\n describes how to add this authorization code to your application.\n\n\n If you're not using one of the client libraries, see [Using OAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) for\n suggestions on obtaining a fresh access token."]]
