Поиск и усиление; Поисковый поток

API отчетов Search Ads 360 имеет унифицированный механизм получения атрибутов и отчетов по показателям , который позволяет создавать запросы с использованием языка запросов Search Ads 360 . Это позволяет выполнять сложные запросы, которые могут возвращать большие объемы данных об отдельных аккаунтах Search Ads 360.

Вы можете создавать запросы, используя методы Search или SearchStream . Оба метода поддерживают одни и те же запросы и возвращают эквивалентные результаты. Метод Search возвращает данные в настраиваемых размерах страниц, что позволяет перебирать набор результатов с помощью разбиения на страницы. Это может быть выгодно в условиях низкой пропускной способности или ненадежной сети, например, для разделения большого набора результатов на более мелкие ответы, которые можно будет повторно получить в случае потери соединения. С другой стороны, метод SearchStream передает весь набор результатов обратно в один ответ, что может быть более эффективно для массового извлечения данных.

И Search , и SearchStream используют один и тот же базовый URL-адрес:

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

Метод поиска на основе страниц принимает необязательный параметр pageSize , который ограничивает количество результатов, возвращаемых в одном ответе API.

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

Если в результатах больше строк, чем pageSize , в ответе возвращается nextPageToken :

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

Повторение того же запроса с добавленным pageToken со значением выше приводит к получению следующей страницы результатов:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

Чтобы использовать метод SearchStream , который возвращает все результаты в одном потоковом ответе, просто измените метод службы в URL-адресе на searchStream ( pageSize и pageToken не требуются для SearchStream ):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}