Method: audienceMembers.ingest

Carica un elenco di risorse AudienceMember nel Destination fornito.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Campi
destinations[]

object (Destination)

Obbligatorio. L'elenco delle destinazioni a cui inviare i membri del segmento di pubblico.
audienceMembers[]

object (AudienceMember)

Obbligatorio. L'elenco degli utenti da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 10.000 risorse AudienceMember.
consent

object (Consent)

(Facoltativo) Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni AudienceMember.
validateOnly

boolean

(Facoltativo) A scopo di test. Se true, la richiesta viene convalidata, ma non eseguita. Vengono restituiti solo gli errori, non i risultati.
encoding

enum (Encoding)

(Facoltativo) Obbligatorio per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Per gli identificatori utente sottoposti ad hashing, questo è il tipo di codifica della stringa sottoposta ad hashing. Per gli identificatori utente sottoposti ad hashing criptato, questo è il tipo di codifica della stringa criptata esterna, ma non necessariamente della stringa sottoposta ad hashing interna, il che significa che la stringa sottoposta ad hashing interna potrebbe essere codificata in modo diverso rispetto alla stringa criptata esterna. Per i caricamenti non UserData, questo campo viene ignorato.
encryptionInfo

object (EncryptionInfo)

(Facoltativo) Informazioni sulla crittografia per i caricamenti di UserData. Se non viene impostato, si presume che i dati identificativi caricati siano sottoposti ad hashing, ma non criptati. Per i caricamenti non UserData, questo campo viene ignorato.
termsOfService

object (TermsOfService)

(Facoltativo) I Termini di servizio che l'utente ha accettato/rifiutato.

Corpo della risposta

Risposta da IngestAudienceMembersRequest.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestId": string
}
Campi
requestId

string

L'ID generato automaticamente della richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

TermsOfService

I Termini di servizio che l'utente ha accettato/rifiutato.

Rappresentazione JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Campi
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

(Facoltativo) Termini di servizio di Customer Match: https://support.google.com/adspolicy/answer/6299717. Questo deve essere accettato per tutti i caricamenti negli elenchi utenti Customer Match.

TermsOfServiceStatus

Rappresenta la decisione del chiamante di accettare o rifiutare i Termini di servizio.

Enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Non specificato.
ACCEPTED Stato che indica che il chiamante ha scelto di accettare i termini di servizio.
REJECTED Stato che indica che il chiamante ha scelto di rifiutare i termini di servizio.