Предыдущий 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 будут по-прежнему поддерживаться.
Ваше первое приложение: Предварительные требования
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Прежде чем вы сможете приступить к написанию своего первого клиентского приложения, вам необходимо сделать несколько вещей, если вы еще этого не сделали.
Создайте аккаунт Google и получите разрешения Search Ads 360.
Чтобы использовать API Search Ads 360, вам потребуется учетная запись Google и соответствующие разрешения, предоставленные этой учетной записи в Search Ads 360:
Если у вас еще нет учетной записи Google, создайте ее .
Попросите менеджера агентства Search Ads 360 создать пользователя Search Ads 360 для вашего аккаунта Google.
Чтобы скачать отчеты, вам потребуется разрешение на просмотр для рекламодателей, с которыми вы будете работать.
Чтобы добавлять или редактировать конверсии, вам потребуется разрешение на редактирование для рекламодателей, с которыми вы будете работать. В общей конфигурации Floodlight вам необходимо разрешение на редактирование для каждого дочернего рекламодателя, которому вы хотите загрузить конверсии. Вам не нужен доступ ни к родительскому рекламодателю, ни к дочерним рекламодателям, в которые вы не загружаете конверсии. Если вы используете идентификаторы кликов для соотнесения конверсий с посещениями , убедитесь, что у вас есть права на редактирование рекламодателя, создавшего идентификатор клика. Если вы укажете идентификатор клика от рекламодателя, к которому у вас нет прав на редактирование, запрос не будет выполнен.
Менеджер агентства может настроить вашу учетную запись как пользователя рекламодателя с доступом к определенным рекламодателям или настроить вашу учетную запись с более высоким уровнем доступа, например, как пользователя агентства с доступом ко всем рекламодателям в агентстве.
Активируйте службу преобразования API
Если вы хотите загрузить данные о конверсиях, пользователю Search Ads 360 с правами менеджера агентства необходимо войти в пользовательский интерфейс Search Ads 360 и активировать службу конвертации API . Инструкции можно найти в Справочном центре Search Ads 360 .
Создайте проект консоли Google API и учетные данные OAuth для вашего клиента.
- Запустите инструмент настройки консоли Google API.
Инструмент настройки поможет вам создать проект (или использовать существующий проект), включить API Search Ads 360 и создать учетные данные OAuth 2.0. - На странице Зарегистрируйте свое приложение выберите существующий проект или выберите Создать проект . Затем нажмите Продолжить .
- После того как консоль Google API включит API Search Ads 360, нажмите кнопку « Перейти к учетным данным» .
- На странице «Создать учетные данные» введите следующую информацию:
- Какой API вы используете? : API Поисковой рекламы 360.
- К каким данным вы будете иметь доступ? : Данные пользователя
- Нажмите кнопку Далее .
Инструмент настройки теперь предлагает помощь в создании идентификатора клиента OAuth 2.0 .
- Выполните остальные шаги в инструменте настройки.
Установите sa360Api.py.
Search Ads 360 предоставляет служебный скрипт, упрощающий процесс настройки авторизации. Вы также можете использовать этот сценарий для отправки и получения данных в формате JSON, если хотите попробовать отправлять и получать данные перед разработкой и написанием полноценного приложения. Вы можете скопировать многие примеры JSON с этого сайта документации и ввести их непосредственно в скрипт.
Чтобы установить скрипт:
- Установите Питон 2.7.
Скрипт не работает с Python 3.x. - Установите Curl .
- Загрузите sa360Api.zip .
- Извлеките
sa360Api.py из sa360Api.zip . - Сделайте
sa360Api.py исполняемым.
Изучите основы REST
Есть два способа вызвать API:
Если вы решите не использовать клиентские библиотеки, вам необходимо понять основы REST.
REST — это стиль архитектуры программного обеспечения, обеспечивающий удобный и последовательный подход к запросу и изменению данных.
Термин REST является сокращением от « Передача представительского состояния ». В контексте API Google это относится к использованию команд HTTP для получения и изменения представлений данных, хранящихся в Google.
В системе RESTful ресурсы хранятся в хранилище данных; клиент отправляет запрос на то, чтобы сервер выполнил определенное действие (например, создание, получение, обновление или удаление ресурса), а сервер выполняет действие и отправляет ответ, часто в форме представления указанного ресурса.
В API-интерфейсах RESTful Google клиент указывает действие с помощью команды HTTP, такой как POST , GET , PUT или DELETE . Он определяет ресурс с помощью глобально уникального URI следующей формы:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Поскольку все ресурсы API имеют уникальные URI, доступные по HTTP, REST обеспечивает кэширование данных и оптимизирован для работы с распределенной инфраструктурой Интернета.
Определения методов в документации по стандартам HTTP 1.1 могут оказаться полезными; они включают спецификации для GET , POST , PUT и DELETE .
REST в API Search Ads 360
Операции Search Ads 360 API напрямую связаны с HTTP-глаголами REST.
Конкретный формат URI Search Ads 360 API:
https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters
Полный набор URI, используемых для каждой поддерживаемой операции в API, обобщен в Справочнике по API .
Изучите основы JSON
Если вы используете REST, вам нужно будет использовать формат JSON для тела запроса. Вы можете указать, что ответы должны быть в формате JSON или CSV.
JSON (нотация объектов JavaScript) — это распространенный, независимый от языка формат данных, который обеспечивает простое текстовое представление произвольных структур данных. Для получения дополнительной информации посетите json.org .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-14 UTC.
[null,null,["Последнее обновление: 2024-11-14 UTC."],[[["\u003cp\u003eBefore using the Search Ads 360 API, ensure you have a Google Account with the necessary Search Ads 360 permissions, which may include view or edit access to specific advertisers.\u003c/p\u003e\n"],["\u003cp\u003eTo upload conversion data, the API Conversion Service must be activated by a Search Ads 360 user with Agency Manager privileges.\u003c/p\u003e\n"],["\u003cp\u003eSet up a Google API Console project and obtain OAuth credentials for your client application to authenticate and authorize API access.\u003c/p\u003e\n"],["\u003cp\u003eInstall the provided \u003ccode\u003esa360Api.py\u003c/code\u003e utility script and familiarize yourself with REST and JSON basics if you plan to interact with the API directly without client libraries.\u003c/p\u003e\n"]]],["To start coding, create a Google Account and request Search Ads 360 permissions from an Agency Manager, who will grant view or edit access to advertisers. Activate the API conversion service via the Search Ads 360 UI. Next, create a Google API Console project and OAuth 2.0 credentials. Install Python 2.7, cURL, and the `sa360Api.py` utility script. Finally, understand REST basics and JSON formatting, crucial for interacting with the API using HTTP requests.\n"],null,["# Your First App: Prerequisites\n\nBefore you can start coding your first client application, there are a few things you\nneed to do, if you haven't done them already.\n\nCreate a Google Account and get Search Ads 360 permissions\n----------------------------------------------------------\n\nTo use the Search Ads 360 API, you need a Google Account and appropriate permissions\ngranted to that account from Search Ads 360:\n\n1. If you don't already have a Google Account, [create one](https://support.google.com/accounts/answer/27441).\n\n2. Ask a Search Ads 360 **Agency Manager** to [create a Search Ads 360 user](https://support.google.com/searchads/answer/6051717) for your Google Account.\n\n To download reports, you'll need **view permission** for the advertisers\n you'll be working with.\n\n To add or edit conversions, you'll need **edit permission** for the advertisers\n you'll be working with. In a\n [shared Floodlight configuration](https://support.google.com/searchads/answer/2458167),\n you need edit permission for each child advertiser you want to upload conversions into.\n You don't need access to the parent advertiser, nor do you need access to child advertisers\n that you're not uploading conversions into. If you use click IDs to\n [attribute\n conversions to visits](/search-ads/v2/how-tos/conversions/insert#attribute-a-conversion-to-a-specific-visit), make sure you have edit access to the advertiser that generated\n the click ID. If you specify a click ID from an advertiser you don't have edit access to,\n the request will not succeed.\n\n The Agency Manager can set up your account as an **Advertiser user** with\n access to specific advertisers,\n or set up your account with a higher level of access such as **Agency user**\n with access to all advertisers in the agency.\n\nActivate the API Conversion Service\n-----------------------------------\n\n\nIf you want to upload data about conversions, a Search Ads 360 user with **Agency\nManager** privileges needs to sign in to the Search Ads 360 UI and\n**activate the API conversion service** . See the\n[Search Ads 360\nhelp center](https://support.google.com/searchads/answer/2604604#activate) for instructions.\n\nCreate a Google API Console project and OAuth credentials for your client\n-------------------------------------------------------------------------\n\n1. Start the Google API Console [setup tool](https://console.cloud.google.com/start/api?id=doubleclicksearch&credential=client_key). \n The setup tool guides you through creating a project (or using an existing project), enabling the Search Ads 360 API, and creating OAuth 2.0 credentials.\n2. On the **Register your application** page, select an existing project or select **Create a project** . Then click **Continue**.\n3. After the Google API Console enables the Search Ads 360 API, click the **Go to credentials** button.\n4. On the **Create credentials** page, enter the following information:\n - **Which API are you using?**: Search Ads 360 API\n - **What data will you be accessing?**: User data\n5. Click the **Next** button.\n\n The setup tool now offers to help you create an **OAuth 2.0 client ID**.\n6. Follow the rest of the steps in the setup tool.\n\nInstall sa360Api.py\n-------------------\n\nSearch Ads 360 provides a utility script to facilitate the process of setting up\nauthorization. You can also use this script to send and receive data in the JSON format,\nif you want to try sending and receiving data before you design and write a full\napplication. You can copy many of the JSON examples in this documentation site and input\nthem directly to the script.\n\nTo install the script:\n\n1. [Install Python](http://www.python.org/getit/) 2.7. \n The script does not work with Python 3.x.\n2. [Install cURL](http://curl.haxx.se/download.html).\n3. [Download sa360Api.zip](https://www.google.com/help/hc/downloads/sa360/sa360Api.zip).\n4. Extract `sa360Api.py` from `sa360Api.zip`.\n5. Make `sa360Api.py` executable.\n\nLearn REST basics\n-----------------\n\nThere are two ways to invoke the API:\n\n- Using [client libraries](/search-ads/v2/libraries).\n- Sending HTTP requests and parsing the responses.\n\nIf you decide not to use client libraries, you'll need to understand the basics of\nREST.\n\nREST is a style of software architecture that provides a convenient and consistent approach to requesting and modifying data.\n\nThe term REST is short for \"[Representational State Transfer](https://en.wikipedia.org/wiki/Representational_state_transfer).\" In the context of Google APIs, it refers to using HTTP verbs to retrieve and modify representations of data stored by Google.\n\nIn a RESTful system, resources are stored in a data store; a client sends a request that the server perform a particular action (such as creating, retrieving, updating, or deleting a resource), and the server performs the action and sends a response, often in the form of a representation of the specified resource.\n\nIn Google's RESTful APIs, the client specifies an action using an HTTP verb such as `POST`, `GET`, `PUT`, or `DELETE`. It specifies a resource by a globally-unique URI of the following form: \n\n```\nhttps://www.googleapis.com/apiName/apiVersion/resourcePath?parameters\n```\n\nBecause all API resources have unique HTTP-accessible URIs, REST enables data caching and is optimized to work with the web's distributed infrastructure.\n\nYou may find the [method definitions](https://tools.ietf.org/html/rfc7231#section-4.3) in the HTTP 1.1 standards documentation useful; they include specifications for `GET`, `POST`, `PUT`, and `DELETE`.\n\n### REST in the Search Ads 360 API\n\nThe Search Ads 360 API operations map directly to REST HTTP verbs.\n\nThe specific format for Search Ads 360 API URIs is: \n\n```\nhttps://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters\n```\n\n\nThe full set of URIs used for each supported operation in the API is summarized in the [API Reference](/search-ads/v2/reference).\n\nLearn JSON basics\n-----------------\n\nIf you use REST, you'll need to use the JSON format for the request bodies. You can\nspecify that the responses be either in the JSON or CSV format.\n\n\n[JSON](http://en.wikipedia.org/wiki/JSON) (JavaScript Object Notation) is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information, see [json.org](http://www.json.org/).\n\n\u003cbr /\u003e"]]
