Method: users.ingest

Faz upload de uma lista de usuários para os destinos fornecidos. Ao contrário do audienceMembers.ingest, que adiciona usuários a listas de público-alvo específicas do anunciante para segmentação, o users.ingest ingere dados de vinculação de identidade no nível da conta (por exemplo, identificadores de usuário vinculados a IDs de dispositivos móveis) independentemente de segmentos de público-alvo específicos.

Esse recurso está disponível apenas para contas em uma lista de permissões.

Solicitação HTTP

POST https://datamanager.googleapis.com/v1/users: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)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Campos
destinations[]

object (Destination)

Obrigatório. A lista de possíveis destinos de ingestão.
users[]

object (User)

Obrigatório. A lista de usuários a serem ingeridos.
encryptionInfo

object (EncryptionInfo)

Opcional. Informações sobre a criptografia das chaves usadas para criptografar os dados.
validateOnly

boolean

Opcional. Se true, a solicitação será validada, mas não executada.
encoding

enum (Encoding)

Obrigatório. O tipo de codificação dos identificadores de usuário. Para identificadores de usuários criptografados, isso se aplica apenas à codificação externa.

Corpo da resposta

Resposta de IngestUsersRequest.

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

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

string

O ID da solicitação de ingestão gerado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Usuário

Representa um único usuário, contendo identificadores como PII e IDs de dispositivos móveis que se referem ao mesmo usuário.

Representação JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Campos
userData

object (UserData)

Obrigatório. Vários dados fornecidos pelo usuário, usados como meio de identificação.
mobileData

object (MobileData)

Obrigatório. Várias strings de ID de dispositivo móvel para representar um único usuário.