Method: customers.searchAudienceInsightsAttributes

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

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

HTTP-запрос

POST https://googleads.googleapis.com/v14/customers/{customerId}:searchAudienceInsightsAttributes

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

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

Параметры
customerId

string

Необходимый. Идентификатор клиента.

Тело запроса

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

JSON-представление
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
Поля
dimensions[]

enum ( AudienceInsightsDimension )

Необходимый. Типы возвращаемых атрибутов.

queryText

string

Необходимый. Бесплатный текстовый запрос. Если запрошенные измерения включают атрибуты CATEGORY или KNOWLEDGE_GRAPH, то атрибуты, возвращаемые для этих измерений, будут соответствовать этой строке или быть связаны с ней. Для других измерений это поле игнорируется и возвращаются все доступные атрибуты.

customerInsightsGroup

string

Имя планируемого клиента. Это определяемое пользователем значение.

locationCountryFilters[]

object ( LocationInfo )

Если атрибуты SUB_COUNTRY_LOCATION являются одним из запрошенных измерений и это поле присутствует, то возвращаемые атрибуты SUB_COUNTRY_LOCATION будут расположены в этих странах. Если это поле отсутствует, атрибуты местоположения не фильтруются по стране. Установка этого поля, если атрибуты SUB_COUNTRY_LOCATION не запрошены, вернет ошибку.

Тело ответа

Ответное сообщение для AudienceInsightsService.ListAudienceInsightsAttributes .

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

JSON-представление
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
Поля
attributes[]

object ( AudienceInsightsAttributeMetadata )

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

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

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

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

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