Method: audienceMembers.ingest

Faz upload de uma lista de recursos AudienceMember para o Destination fornecido.

Solicitação HTTP

POST https://datamanager.googleapis.com/v1/audienceMembers:ingest

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Campos
destinations[]

object (Destination)

Obrigatório. A lista de destinos para enviar os membros do público-alvo.
audienceMembers[]

object (AudienceMember)

Obrigatório. A lista de usuários para enviar aos destinos especificados. No máximo 10.000 recursos AudienceMember podem ser enviados em uma única solicitação.
consent

object (Consent)

Opcional. Consentimento no nível da solicitação para aplicar a todos os usuários na solicitação. O consentimento no nível do usuário substitui o consentimento no nível da solicitação e pode ser especificado em cada AudienceMember.
validateOnly

boolean

Opcional. Para fins de teste. Se true, a solicitação será validada, mas não executada. Apenas erros são retornados, não resultados.
encoding

enum (Encoding)

Opcional. Obrigatório para uploads de UserData. O tipo de codificação dos identificadores de usuário. Para identificadores de usuário com hash, esse é o tipo de codificação da string com hash. Para identificadores de usuário criptografados com hash, esse é o tipo de codificação da string criptografada externa, mas não necessariamente da string com hash interna. Isso significa que a string com hash interna pode ser codificada de uma maneira diferente da string criptografada externa. Para uploads que não são UserData, esse campo é ignorado.
encryptionInfo

object (EncryptionInfo)

Opcional. Informações de criptografia para uploads do UserData. Se não for definido, será presumido que as informações de identificação enviadas foram criptografadas com hash, mas não criptografadas. Para uploads que não são UserData, esse campo é ignorado.
termsOfService

object (TermsOfService)

Opcional. Os Termos de Serviço que o usuário aceitou/rejeitou.

Corpo da resposta

Resposta do IngestAudienceMembersRequest.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "requestId": string
}
Campos
requestId

string

O ID gerado automaticamente da solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

TermsOfService

Os Termos de Serviço que o usuário aceitou/rejeitou.

Representação JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Campos
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Opcional. Os Termos de Serviço da Segmentação por lista de clientes: https://support.google.com/adspolicy/answer/6299717. Isso precisa ser aceito ao ingerir UserData ou MobileData. Esse campo não é obrigatório para a lista de usuários da Segmentação por parceiro.

TermsOfServiceStatus

Representa a decisão do autor da chamada de aceitar ou rejeitar os Termos de Serviço.

Tipos enumerados
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Não especificado.
ACCEPTED Status que indica que o autor da chamada escolheu aceitar os Termos de Serviço.
REJECTED Status que indica que o autor da chamada escolheu rejeitar os Termos de Serviço.