Method: audienceMembers.ingest

Carica un elenco di risorse AudienceMember nella Destination fornita.

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 è possibile inviare al massimo 10.000 risorse AudienceMember.
consent

object (Consent)

Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti nella 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. Deve essere fornito per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Per gli identificatori utente con hash, questo è il tipo di codifica della stringa con hash. Per gli identificatori utente con hash criptati, questo è il tipo di codifica della stringa criptata esterna, ma non necessariamente della stringa con hash interna, il che significa che la stringa con hash 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 è impostato, si presuppone che le informazioni identificative caricate siano con hash ma non criptate. 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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Campi
requestId

string

L'ID generato automaticamente della richiesta.
fieldWarnings[]

object (FieldWarning)

Avvisi dettagliati a livello di riga con percorsi dei campi.

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. I Termini di servizio di Customer Match: https://support.google.com/adspolicy/answer/6299717. Devono essere accettati quando si inseriscono UserData o MobileData. Questo campo non è obbligatorio per l'elenco utenti di Partner 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.