Method: customers.userLists.mutate

Crea o aggiorna gli elenchi di utenti. Vengono restituiti gli stati delle operazioni.

Elenco di errori generati: AuthenticationError AuthorizationError CollectionSizeError DatabaseError DistinctError FieldError FieldMaskError HeaderError InternalError MutateError NewResourceCreationErrorNotAllowlistedErrorNotEmptyErrorOperationAccessDeniedErrorQuotaErrorRangeErrorRequestErrorStringFormatErrorStringLengthErrorUserListError

Richiesta HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/userLists:mutate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

obbligatorio. L'ID del cliente i cui elenchi utenti vengono modificati.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "operations": [
    {
      object (UserListOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campi
operations[]

object (UserListOperation)

obbligatorio. L'elenco di operazioni da eseguire sui singoli elenchi di utenti.
partialFailure

boolean

Se il valore è true, le operazioni andate a buon fine vengono eseguite e le operazioni non valide restituiranno errori. Se il valore è false, tutte le operazioni verranno eseguite in una sola transazione se e solo se sono tutte valide. Il valore predefinito è false.
validateOnly

boolean

Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati.

Corpo della risposta

Modifica del messaggio di risposta per la modifica dell'elenco utenti.

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

Rappresentazione JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateUserListResult)
    }
  ]
}
Campi
partialFailureError

object (Status)

Errori relativi agli errori delle operazioni in modalità di errore parziale. Restituito solo quando incompleteFailure = true e tutti gli errori si verificano all'interno delle operazioni. Se si verificano errori al di fuori delle operazioni (ad esempio, errori di autenticazione), restituiamo un errore a livello di RPC.
results[]

object (MutateUserListResult)

Tutti i risultati per la mutazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.