- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Prova!
Crea o rimuove gli insiemi di asset del cliente. Vengono restituiti gli stati delle operazioni.
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerAssetSets:mutate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
obbligatorio. L'ID del cliente i cui set di asset per clienti sono in fase di modifica. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "operations": [ { object ( |
Campi | |
---|---|
operations[] |
obbligatorio. L'elenco delle operazioni da eseguire sugli insiemi di asset dei singoli clienti. |
partialFailure |
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 |
Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati. |
responseContentType |
L'impostazione del tipo di contenuti della risposta. Determina se la risorsa mutabile o solo il nome della risorsa deve essere restituito dopo la modifica. |
Corpo della risposta
Modifica del messaggio di risposta per un set di asset del cliente.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "results": [ { object ( |
Campi | |
---|---|
results[] |
Tutti i risultati per la mutazione. |
partialFailureError |
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 es. errori di autenticazione), restituiamo un errore a livello di RPC. |
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.
CustomerAssetSetOperation
Una singola operazione (creazione, rimozione) su un set di asset del cliente.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione operation . L'operazione di modifica. operation può essere solo uno dei seguenti: |
|
create |
Operazione di creazione: non è previsto alcun nome di risorsa per il set di asset del nuovo cliente. |
remove |
Operazione di rimozione: è previsto un nome risorsa per il set di asset del cliente rimosso, nel formato |
MutateCustomerAssetSetResult
Il risultato per l'insieme di asset del cliente cambia.
Rappresentazione JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Campi | |
---|---|
resourceName |
Restituito per operazioni riuscite. |
customerAssetSet |
L'insieme di asset del cliente mutato con solo campi modificabili dopo la modifica. Il campo viene restituito solo quando responseContentType è impostato su "MUTABLE_RESOURCE". |