Method: customers.googleAds.search

Возвращает все строки, соответствующие поисковому запросу.

Список выброшенных ошибок: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v16/customers/{customerId}/googleAds:search

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор запрашиваемого клиента.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
Поля
query

string

Необходимый. Строка запроса.

pageToken

string

Токен страницы, которую нужно получить. Если не указано, будет возвращена первая страница результатов. Используйте значение, полученное из nextPageToken в предыдущем ответе, чтобы запросить следующую страницу результатов.

pageSize

integer

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

validateOnly

boolean

Если это правда, запрос проверяется, но не выполняется.

returnTotalResultsCount

boolean

Если это правда, общее количество результатов, соответствующих запросу, игнорирующему предложение LIMIT, будет включено в ответ. По умолчанию — ложь.

summaryRowSetting

enum ( SummaryRowSetting )

Определяет, будет ли возвращена сводная строка. По умолчанию сводная строка не возвращается. По запросу строка сводки будет отправлена ​​в ответ сама по себе после того, как будут возвращены все остальные результаты запроса.

Тело ответа

Ответное сообщение для GoogleAdsService.Search .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "results": [
    {
      object (GoogleAdsRow)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "queryResourceConsumption": string
}
Поля
results[]

object ( GoogleAdsRow )

Список строк, соответствующих запросу.

nextPageToken

string

Токен нумерации страниц, используемый для получения следующей страницы результатов. Передайте содержимое этой строки в качестве атрибута pageToken следующего запроса. nextPageToken не возвращается для последней страницы.

totalResultsCount

string ( int64 format)

Общее количество результатов, соответствующих запросу, игнорирующему предложение LIMIT.

fieldMask

string ( FieldMask format)

FieldMask, указывающий, какие поля были запрошены пользователем.

Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" .

summaryRow

object ( GoogleAdsRow )

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

queryResourceConsumption

string ( int64 format)

Объем ресурсов, потребляемых для обслуживания запроса.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .