Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google
searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
Method: searchAds360Fields.search
HTTP-запрос
POST https://searchads360.googleapis.com/v0/searchAds360Fields:search
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"query": string,
"pageToken": string,
"pageSize": integer
} |
Поля |
---|
query | string Необходимый. Строка запроса. |
page Token | string Токен страницы, которую нужно получить. Если не указано, будет возвращена первая страница результатов. Используйте значение, полученное из nextPageToken в предыдущем ответе, чтобы запросить следующую страницу результатов. |
page Size | integer Количество элементов, которые нужно получить на одной странице. Когда запрашивается слишком большая страница, сервер может принять решение дополнительно ограничить количество возвращаемых ресурсов. |
Тело ответа
Ответное сообщение для SearchAds360FieldService.SearchSearchAds360Fields
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"results": [
{
object (SearchAds360Field )
}
],
"nextPageToken": string,
"totalResultsCount": string
} |
Поля |
---|
results[] | object ( SearchAds360Field ) Список полей, соответствующих запросу. |
next Page Token | string Токен нумерации страниц, используемый для получения следующей страницы результатов. Передайте содержимое этой строки в качестве атрибута pageToken следующего запроса. nextPageToken не возвращается для последней страницы. |
total Results Count | string ( int64 format) Общее количество результатов, соответствующих запросу, игнорирующему предложение LIMIT. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/doubleclicksearch
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-19 UTC.
[null,null,["Последнее обновление: 2024-11-19 UTC."],[[["Search and retrieve SearchAds360 fields that match a specific query using the provided endpoint."],["Requests can specify query parameters for filtering, pagination, and the number of results to return."],["Responses include a list of matching fields, pagination information, and the total number of results."],["Authorization requires the `https://www.googleapis.com/auth/doubleclicksearch` scope."],["Potential errors include AuthenticationError, AuthorizationError, HeaderError, InternalError, QueryError, QuotaError, and RequestError."]]],["This document details how to search for fields using the Search Ads 360 API. A `POST` request is sent to `https://searchads360.googleapis.com/v0/searchAds360Fields:search`, including a JSON body with a `query` string, optional `pageToken`, and `pageSize`. The response includes a list of matching field `results`, a `nextPageToken` for pagination, and a `totalResultsCount`. This operation requires the `https://www.googleapis.com/auth/doubleclicksearch` OAuth scope. Several errors such as `AuthenticationError` and `QuotaError` can be thrown.\n"]]