Method: customers.searchAds360.searchStream

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

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

HTTP-запрос

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:searchStream

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

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

Параметры
customerId

string

Обязательно. Идентификатор клиента, к которому обращается запрос.

Текст запроса

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

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

string

Обязательно. Строка запроса.

batchSize

integer

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

summaryRowSetting

enum ( SummaryRowSetting )

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

Ответный текст

Ответное сообщение для SearchAds360Service.SearchStream .

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

JSON-представление 
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ],
  "requestId": string
}
Поля
results[]

object ( SearchAds360Row )

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

fieldMask

string ( FieldMask format)

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

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

summaryRow

object ( SearchAds360Row )

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

customColumnHeaders[]

object ( CustomColumnHeader )

Заголовки пользовательских столбцов в результатах.

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

Заголовки пользовательских метрик конверсии в результатах.

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

Заголовки пользовательского параметра конверсии в результатах.

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

Заголовки исходных метрик конверсии событий в результатах.

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

Заголовки параметров конверсии исходных событий в результатах.

requestId

string

Уникальный идентификатор запроса, используемый в целях отладки.

Области полномочий

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

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