Возвращает все строки, соответствующие запросу потока поиска.
Список выброшенных ошибок: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v17/customers/{customerId}/googleAds:searchStream
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор запрашиваемого клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"query": string,
"summaryRowSetting": enum ( |
Поля | |
---|---|
query | Необходимый. Строка запроса. |
summaryRowSetting | Определяет, будет ли возвращена сводная строка. По умолчанию сводная строка не возвращается. По запросу строка сводки будет отправлена в ответе сама по себе после того, как будут возвращены все остальные результаты запроса. |
Тело ответа
Ответное сообщение для GoogleAdsService.SearchStream
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "results": [ { object ( |
Поля | |
---|---|
results[] | Список строк, соответствующих запросу. |
fieldMask | FieldMask, указывающий, какие поля были запрошены пользователем. Это разделенный запятыми список полных имен полей. Пример: |
summaryRow | Строка сводки, содержащая сводку показателей в результатах. Сводка показателей означает агрегирование показателей по всем результатам, здесь агрегирование может быть суммой, средним значением, частотой и т. д. |
requestId | Уникальный идентификатор запроса, который используется в целях отладки. |
queryResourceConsumption | Объем ресурсов, потребляемых для обслуживания запроса. queryResourceConsumption для строки «Сводка» и ответы, отличные от «Сводка», возвращаются отдельно в соответствующих строках. queryResourceConsumption для ответов, отличных от сводных, возвращается в финальном пакете результатов. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .