Cuidado: você está vendo a documentação da interface REST da API. A maioria das nossas bibliotecas de cliente oficiais usa o gRPC. Consulte Introdução ao REST para ver mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

CustomAudience

Representação JSON
CustomAudienceStatus
CustomAudienceType
CustomAudienceMember
- Representação JSON
CustomAudienceMemberType

Um público-alvo personalizado. Esta é uma lista de usuários por interesse.

Representação JSON

Representação JSON
{ "resourceName": string, "id": string, "status": enum (`CustomAudienceStatus`), "name": string, "type": enum (`CustomAudienceType`), "description": string, "members": [ { object (`CustomAudienceMember`) } ] }

{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}

Campos
`resourceName`	`string` Imutável. O nome do recurso do público-alvo personalizado. Os nomes dos recursos de público-alvo personalizados têm o seguinte formato: `customers/{customerId}/customAudiences/{custom_audience_id}`
`id`	`string (int64 format)` Apenas saída. ID do público-alvo personalizado.
`status`	`enum (CustomAudienceStatus)` Apenas saída. Status desse público-alvo personalizado. Indica se o público-alvo personalizado está ativado ou removido.
`name`	`string` Nome do público-alvo personalizado. Ele precisa ser exclusivo para todos os públicos-alvo personalizados criados por um cliente. Este campo é obrigatório para a criação de operações.
`type`	`enum (CustomAudienceType)` Tipo de público-alvo personalizado. "INTEREST" OU "PURCHASE_INTENT" não é permitido para públicos-alvo personalizados recém-criados, mas são mantidos para os atuais.
`description`	`string` É a descrição desse público-alvo personalizado.
`members[]`	`object (CustomAudienceMember)` Lista de participantes do público-alvo personalizado que compõe esse público-alvo personalizado. Os membros podem ser adicionados durante a criação do CustomAudience. Se os membros forem apresentados na operação UPDATE, os membros existentes serão substituídos.

CustomAudienceStatus

Enumeração que contém possíveis status do público-alvo personalizado.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`ENABLED`	Status ativado: o público-alvo personalizado está ativado e pode ser segmentado.
`REMOVED`	Status removido: o público-alvo personalizado foi removido e não pode ser usado para segmentação.

CustomAudienceType

Enumeração contendo possíveis tipos de público-alvo personalizado.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`AUTO`	O Google Ads selecionará automaticamente a melhor interpretação no momento da veiculação.
`INTEREST`	Corresponde aos usuários pelos interesses deles.
`PURCHASE_INTENT`	Corresponde aos usuários por tópicos que eles pesquisam ou por produtos que estão considerando para comprar.
`SEARCH`	Corresponde aos usuários pelo que eles pesquisaram na Pesquisa Google.

CustomAudienceMember

Membro de um público-alvo personalizado. Um membro pode ser uma KEYWORD, URL, PLACE_CATEGORY ou APP. Ele só pode ser criado ou removido, mas não alterado.

Representação JSON

Representação JSON
{ "memberType": enum (`CustomAudienceMemberType`), // Union field `value` can be only one of the following: "keyword": string, "url": string, "placeCategory": string, "app": string // End of list of possible types for union field `value`. }

{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}

Campos
`memberType`	`enum (CustomAudienceMemberType)` O tipo de participante do público-alvo personalizado, KEYWORD, URL, PLACE_CATEGORY ou APP.
Campo de união `value`. O valor CustomAudienceMember. Um campo é preenchido dependendo do tipo de membro. `value` pode ser apenas de um dos tipos a seguir:
`keyword`	`string` Uma palavra-chave ou frase de palavra-chave com no máximo 10 palavras e 80 caracteres. Os idiomas com caracteres duplos, como chinês, japonês ou coreano, podem ter 40 caracteres, que descrevem os interesses ou as ações do usuário.
`url`	`string` Um URL HTTP, protocolo incluído, com no máximo 2.048 caracteres, que inclui conteúdo em que os usuários têm interesse.
`placeCategory`	`string (int64 format)` Um tipo de lugar descrito por uma categoria de lugar que os usuários visitam.
`app`	`string` Um nome de pacote de apps Android que os usuários instalaram, como com.google.example.

CustomAudienceMemberType

Enumeração contendo possíveis tipos de membros do público personalizado.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
`KEYWORD`	Usuários cujos interesses ou ações são descritos por uma palavra-chave.
`URL`	Usuários que têm interesses relacionados ao conteúdo do site.
`PLACE_CATEGORY`	Usuários que visitam tipos de lugares descritos por uma categoria.
`APP`	Usuários que instalaram um app para dispositivos móveis.