Modificare oggetti

Come descritto nella guida alla struttura dell'API, ogni risorsa di primo livello nell'API Google Ads ha un servizio specifico per il tipo di risorsa corrispondente che supporta la modifica delle istanze della risorsa.

Questa guida utilizzerà CampaignService per mostrare come modificare gli oggetti Campaign, ma gli stessi concetti si applicano a tutti gli altri servizi specifici per il tipo di risorsa.

Modificare gli oggetti

Ogni servizio specifico per il tipo di risorsa avrà un metodo mutate che accetta una richiesta di modifica. Questa richiesta è composta da:

• Un customerId
• Una raccolta di operazioni
• Un'impostazione del tipo di contenuto della risposta che determina se la risorsa modificabile o solo il nome della risorsa deve essere restituito dopo la modifica.

Ad esempio, il metodo MutateCampaigns di CampaignService accetta un MutateCampaignsRequest composto da:

• Un customerId
• Una raccolta di oggetti CampaignOperation
• Il campo response_content_type che indica il tipo di risposta preferito.

Operazioni

Un oggetto operazione come CampaignOperation ti consente di specificare l'azione che vuoi eseguire su una singola risorsa impostando il relativo campo operation. Questo campo è un campo oneof composto dai seguenti attributi il cui tipo è il tipo di risorsa:

create

Crea una nuova istanza della risorsa.

update

Aggiorna la risorsa in modo che corrisponda agli attributi di update

risorsa. Quando questo campo è impostato, devi impostare anche update_mask dell'operazione, che indica all'API Google Ads quali attributi modificare durante l'operazione di aggiornamento. Ogni libreria client ha un metodo di utilità o helper che genera update_mask per te, come mostrato nelle nostre librerie client.

remove

Rimuove la risorsa.

Poiché il campo operation è un campo oneof, non puoi utilizzare una singola operazione per modificare più oggetti. Ad esempio, se vuoi creare una campagna e rimuoverne un'altra, aggiungi due istanze di CampaignOperation alla richiesta: una con create impostato e un'altra con remove impostato.

Operazioni batch

Sebbene una singola operazione possa solo creare, aggiornare o rimuovere una singola risorsa, una singola richiesta di modifica può contenere più operazioni. Ti consigliamo di combinare le operazioni in una singola richiesta di modifica anziché inviare più richieste di modifica, ognuna contenente una singola operazione.

Ad esempio, se vuoi creare dieci campagne, devi inviare una singola MutateCampaignsRequest con dieci oggetti CampaignOperation.

Risposte di modifica

Ciò che viene restituito nella risposta dipende da ciò che è stato inviato nel response_content_type della richiesta di modifica. Ad esempio, se MUTABLE_RESOURCE è stato specificato, allora la risposta conterrà solo i campi modificabili della campagna. Puoi quindi eseguire modifiche successive sull'oggetto risorsa senza doverlo ricostruire.

Errori di modifica

Le operazioni in una determinata richiesta di modifica verranno applicate al tuo account Google Ads solo se ogni operazione nella richiesta ha esito positivo. Consulta la guida agli errori comuni per un elenco di errori comuni e su come risolverli.

Monitorare le modifiche

Per monitorare le modifiche apportate agli oggetti nel tuo account Google Ads o per recuperare lo stato attuale degli oggetti, puoi utilizzare le risorse change_status e change_event.

• change_status fornisce un riepilogo delle risorse che sono state modificate in un determinato periodo di tempo.
• change_event fornisce una cronologia dettagliata delle modifiche, inclusi i valori precedenti e nuovi dei campi modificati.

Per eseguire query su queste risorse, utilizza il GoogleAdsService.SearchStream o GoogleAdsService.Search metodo. Scopri di più sullo streaming dei report utilizzando GoogleAdsService.