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 personalizado 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 foi 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 um público-alvo personalizado recém-criado, mas é mantido para os atuais)
`description`	`string` Descrição desse público-alvo personalizado.
`members[]`	`object (CustomAudienceMember)` Lista de membros do público-alvo personalizado que compõe o público-alvo personalizado. Os membros podem ser adicionados durante a criação de CustomAudience. Se os membros forem apresentados na operação UPDATE, os membros existentes serão substituídos.

CustomAudienceStatus

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

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um 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 um valor desconhecido nesta versão.
`AUTO`	O Google Ads vai selecionar automaticamente a melhor interpretação no momento da veiculação.
`INTEREST`	Faz a correspondência dos usuários pelos interesses deles.
`PURCHASE_INTENT`	Faz a correspondência de usuários por tópicos que estão pesquisando ou por produtos que estão considerando para compra.
`SEARCH`	Faz a correspondência entre os usuários pelo que eles pesquisaram na Pesquisa Google.

CustomAudienceMember

Participante do 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 pode ser 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: no máximo 10 palavras e 80 caracteres. Idiomas com caracteres duplos, como chinês, japonês ou coreano, podem ter até 40 caracteres, que descrevem os interesses ou as ações do usuário.
`url`	`string` Um URL HTTP, incluído em protocolo, com no máximo 2.048 caracteres, que inclui conteúdos 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-alvo personalizado.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um 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 lugar descritos por uma categoria de lugar.
`APP`	Usuários que instalaram um app para dispositivos móveis.