Method: customers.uploadUserData

Carica i dati utente specificati.

Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Richiesta HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente per il quale aggiornare i dati utente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campi
operations[]

object (UserDataOperation)

Obbligatorio. L'elenco delle operazioni da eseguire.
Campo di unione metadata. Metadati della richiesta. metadata può essere solo uno dei seguenti:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadati per gli aggiornamenti dei dati di un elenco di utenti Customer Match.

Corpo della risposta

Messaggio di risposta per UserDataService.UploadUserData I caricamenti effettuati tramite questo servizio non saranno visibili nella sezione "Membri del segmento" per l'elenco Customer Match nell'interfaccia utente di Google Ads.

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

Rappresentazione JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Campi
uploadDateTime

string

L'ora in cui la richiesta è stata ricevuta dall'API, nel formato "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

Numero di operazioni di caricamento dei dati ricevute dall'API.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

UserDataOperation

Operazione da eseguire per UploadUserDataRequest.

Rappresentazione JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Campi
Campo di unione operation. Operazione da eseguire per UploadUserDataRequest. operation può essere solo uno dei seguenti:
create

object (UserData)

L'elenco di dati utente da aggiungere all'elenco utenti.
remove

object (UserData)

L'elenco di dati utente da rimuovere dall'elenco utenti.