Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Настроить авторизацию
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
API Search Ads 360 требует, чтобы во всех запросах указывался токен доступа OAuth 2.0 для аутентификации. Вы можете использовать любой стандартный рабочий процесс аутентификации OAuth 2.0, чтобы сгенерировать токен и передать его в API Search Ads 360. Мы рекомендуем описанный ниже рабочий процесс, поскольку он подходит для полностью автоматизированной загрузки конверсий и отчетов.
Альтернативы описанному ниже рабочему процессу см. в разделах «Использование OAuth 2.0 для установленных приложений» или «Использование OAuth 2.0 для межсерверных приложений» . Если вы используете альтернативный рабочий процесс, укажите следующее значение в качестве параметра scope при запросе кода авторизации OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Если вы следуете по маршруту от сервера к серверу, добавьте сервисный аккаунт в качестве пользователя Search Ads 360.
Рекомендуемый процесс авторизации
- Перейдите в консоль Google API и выберите свой проект.
Если вы еще не создали проект консоли Google API и учетные данные OAuth, следуйте инструкциям в разделе Создание проекта консоли Google API и учетных данных OAuth для вашего клиента .
Чтобы найти идентификатор и секрет клиента OAuth вашего проекта, выполните следующие действия:
- Откройте страницу учетных данных .
- В столбце «Имя » щелкните имя вашего клиента OAuth.
- Идентификатор клиента и секретный код указаны на странице.
- Откройте веб-браузер и войдите в Google, используя учетную запись Google, у которой есть разрешение на доступ к данным в Search Ads 360.
Это учетная запись Google, которую ваш API-клиент будет использовать для аутентификации в Search Ads 360. Если владелец учетной записи Google покинет вашу компанию и вы удалите доступ к Search Ads 360 из этой учетной записи, вам нужно будет повторить этот рабочий процесс авторизации и указать другую учетную запись Google. .
- Получите токен обновления, вызвав служебный скрипт Search Ads 360 следующим образом:
sa360Api.py --login
Сценарий проведет вас через процесс использования идентификатора и секрета клиента Oauth для получения токена обновления. Токен обновления действителен только для той учетной записи Google, в которую вы вошли на предыдущем шаге.
В рамках этого процесса сценарий генерирует URL-адрес и предлагает вам посетить этот URL-адрес в веб-браузере.
Когда браузер попросит вас разрешить клиенту OAuth доступ к данным Search Ads 360, убедитесь, что отображается аккаунт Google, в который вы вошли ранее. (Если вы вошли в несколько учетных записей Google, вам может быть представлена другая учетная запись.)
В конце процесса сценарий sa360Api.py выводит строку, разделенную запятыми. Первое значение — это предоставленный вами идентификатор клиента, второе значение — это предоставленный вами секрет клиента, а третье значение — это токен обновления. В следующем примере вывода токен обновления выделен жирным шрифтом :
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef, 1/HIJklM01OPQR23NOP456rst890uvw
- Сохраните идентификатор клиента, секрет клиента и токен обновления во внутренней базе данных или другом безопасном месте, доступном для вашего приложения.
Сохраните всю строку, разделенную запятыми, в удобном месте, если вы планируете использовать sa360Api.py для отправки примеров запросов JSON в Search Ads 360 API. Вы будете передавать всю строку в качестве параметра каждый раз, когда вызываете скрипт.
- Добавьте в приложение код, который выполняет следующие действия:
- Используйте идентификатор клиента, секрет клиента и токен обновления, чтобы получить новый токен доступа OAuth 2.0.
- Отправляйте запросы к API Search Ads 360, используя новый токен доступа.
Если вы используете клиентские библиотеки, в следующем разделе «Настройка приложения» описывается, как добавить этот код авторизации в ваше приложение.
Если вы не используете ни одну из клиентских библиотек, ознакомьтесь с рекомендациями по получению нового токена доступа в разделе «Использование OAuth 2.0 для установленных приложений» .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-08 UTC.
[null,null,["Последнее обновление: 2024-11-08 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."]]
