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 a los que se enviará el mensaje a los destinos especificados. Se pueden enviar como máximo 10,000 recursos AudienceMember en una sola solicitud.
consent

object (Consent)

Opcional. Es el consentimiento a nivel de la solicitud que se aplica a todos los usuarios incluidos en 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

Opcional. Solo con fines de prueba. Si es true, la solicitud se valida, pero no se ejecuta. Solo se devuelven errores, no resultados.
encoding

enum (Encoding)

Opcional. Se requiere para las cargas de UserData. Es el tipo de codificación de los identificadores de usuario. En el caso de los identificadores de usuario hash, este es el tipo de codificación de la cadena hash. En el caso de 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 podría estar codificada de una manera diferente a la cadena encriptada externa. En el caso de las cargas que no son de UserData, este campo se ignora.
encryptionInfo

object (EncryptionInfo)

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 codificación hash, pero no está encriptada. En el caso de las cargas que no son de UserData, este campo se ignora.
termsOfService

object (TermsOfService)

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
}
Campos
requestId

string

Es el ID generado automáticamente de la solicitud.

Permisos de autorización

Requiere el siguiente alcance 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)

Opcional. Condiciones del servicio de Segmentación por clientes: https://support.google.com/adspolicy/answer/6299717 Se debe aceptar cuando se ingieren UserData o MobileData. Este campo no es obligatorio para la lista de usuarios de la 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 llamante eligió aceptar las condiciones del servicio.
REJECTED Es el estado que indica que el llamador eligió rechazar las condiciones del servicio.