Method: audienceMembers.ingest

Sube una lista de recursos AudienceMember al Destination proporcionado.

Solicitud HTTP

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

object (Destination)

Obligatorio. Es la lista de destinos a los que se enviarán los miembros del público.
audienceMembers[]

object (AudienceMember)

Obligatorio. Es la lista de usuarios que se enviarán a los destinos especificados. Se pueden enviar como máximo 10,000 recursos AudienceMember en una sola solicitud.
consent

object (Consent)

Es opcional. Es el consentimiento a nivel de la solicitud que se aplica a todos los usuarios de la solicitud. El consentimiento a nivel del usuario anula el consentimiento a nivel de la solicitud y se puede especificar en cada AudienceMember.
validateOnly

boolean

Es opcional. Es para fines de prueba. Si es true, la solicitud se valida, pero no se ejecuta. Solo se muestran los errores, no los resultados.
encoding

enum (Encoding)

Es opcional. Se debe proporcionar para las cargas de UserData. Es el tipo de codificación de los identificadores de usuario. Para los identificadores de usuario con hash, este es el tipo de codificación de la cadena con hash. Para los identificadores de usuario con hash encriptados, este es el tipo de codificación de la cadena encriptada externa, pero no necesariamente de la cadena con hash interna, lo que significa que la cadena con hash interna se podría codificar de una manera diferente a la cadena encriptada externa. Para las cargas que no son de UserData, se ignora este campo.
encryptionInfo

object (EncryptionInfo)

Es opcional. Es la información de encriptación para las cargas de UserData. Si no se configura, se supone que la información de identificación subida tiene hash, pero no está encriptada. Para las cargas que no son de UserData, se ignora este campo.
termsOfService

object (TermsOfService)

Es opcional. Son las Condiciones del Servicio que el usuario aceptó o rechazó.

Cuerpo de la respuesta

Respuesta de IngestAudienceMembersRequest.

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

Representación JSON 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Campos
requestId

string

Es el ID generado automáticamente de la solicitud.
fieldWarnings[]

object (FieldWarning)

Son advertencias detalladas a nivel de la fila con rutas de acceso a los campos.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

TermsOfService

Son las Condiciones del Servicio que el usuario aceptó o rechazó.

Representación JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Campos
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Es opcional. Son las Condiciones del Servicio de Segmentación por clientes: https://support.google.com/adspolicy/answer/6299717. Se deben aceptar cuando se ingieren UserData o MobileData. Este campo no es obligatorio para la lista de usuarios de Segmentación por socios.

TermsOfServiceStatus

Representa la decisión del llamador de aceptar o rechazar las Condiciones del Servicio.

Enums
TERMS_OF_SERVICE_STATUS_UNSPECIFIED No se especifica.
ACCEPTED Es el estado que indica que el llamador eligió aceptar las Condiciones del Servicio.
REJECTED Es el estado que indica que el llamador eligió rechazar las Condiciones del Servicio.