Method: customers.searchAds360.search

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

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

HTTP-запрос

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

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

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

Параметры
customer Id

string

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

Тело запроса

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

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

string

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

page Token

string

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

page Size

integer

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

validate Only

boolean

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

return Total Results Count

boolean

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

summary Row Setting

enum ( SummaryRowSetting )

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

Тело ответа

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

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

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

object ( SearchAds360Row )

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

next Page Token

string

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

total Results Count

string ( int64 format)

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

field Mask

string ( FieldMask format)

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

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

summary Row

object ( SearchAds360Row )

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

custom Column Headers[]

object ( CustomColumnHeader )

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

conversion Custom Metric Headers[]

object ( ConversionCustomMetricHeader )

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

conversion Custom Dimension Headers[]

object ( ConversionCustomDimensionHeader )

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

raw Event Conversion Metric Headers[]

object ( RawEventConversionMetricHeader )

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

raw Event Conversion Dimension Headers[]

object ( RawEventConversionDimensionHeader )

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

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

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

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