Method: users.ingest

Sube una lista de usuarios a los destinos proporcionados. A diferencia de audienceMembers.ingest (que agrega usuarios a listas de público específicas del anunciante para la segmentación), users.ingest incorpora datos de vinculación de identidades a nivel de la cuenta (por ejemplo, identificadores de usuarios vinculados a IDs de dispositivos móviles) independientemente de los segmentos de público específicos.

Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Campos
destinations[]

object (Destination)

Obligatorio. Es la lista de posibles destinos de transferencia.
users[]

object (User)

Obligatorio. Es la lista de usuarios que se deben transferir.
encryptionInfo

object (EncryptionInfo)

Opcional. Es la información de encriptación sobre las claves de encriptación que se usan para encriptar los datos.
validateOnly

boolean

Opcional. Si es true, se valida la solicitud, pero no se ejecuta.
encoding

enum (Encoding)

Obligatorio. Es el tipo de codificación de los identificadores de usuario. En el caso de los identificadores de usuario encriptados, esto solo se aplica a la codificación externa.

Cuerpo de la respuesta

Es la respuesta de IngestUsersRequest.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "requestId": string
}
Campos
requestId

string

Es el ID de solicitud generado de la solicitud de carga.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Usuario

Representa a un solo usuario y contiene identificadores como la PII y los IDs de dispositivos móviles que hacen referencia al mismo usuario.

Representación JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Campos
userData

object (UserData)

Obligatorio. Son varios elementos de datos proporcionados por el usuario que se utilizan como medio para identificarlo.
mobileData

object (MobileData)

Obligatorio. Son varias cadenas de ID de dispositivos móviles que representan a un solo usuario.