Modifier des objets

Comme indiqué dans le guide sur la structure de l'API, chaque ressource de premier niveau de l'API Google Ads dispose d'un service spécifique au type de ressource qui permet de modifier les instances de la ressource.

Ce guide utilise CampaignService pour montrer comment modifier des objets Campaign, mais les mêmes concepts s'appliquent à tous les autres services spécifiques au type de ressource.

Modifier des objets

Chaque service spécifique au type de ressource dispose d'une méthode mutate qui accepte une requête de mutation. Cette requête se compose des éléments suivants :

• Un customerId
• Un ensemble d'opérations
• Un paramètre de type de contenu de réponse qui détermine si la ressource modifiable ou uniquement le nom de la ressource doit être renvoyé après la mutation.

Par exemple, la MutateCampaigns méthode de CampaignService accepte un MutateCampaignsRequest qui se compose des éléments suivants :

• Un customerId
• Un ensemble d'objets CampaignOperation
• Le champ response_content_type indiquant le type de réponse préféré.

Opérations

Un objet d'opération tel que CampaignOperation vous permet de spécifier l'action que vous souhaitez effectuer sur une seule ressource en définissant son champ operation. Ce champ est un champ "oneof" composé des attributs suivants dont le type est le type de ressource :

create

Crée une instance de la ressource.

update

Met à jour la ressource pour qu'elle corresponde aux attributs de la update

ressource. Lorsque ce champ est défini, vous devez également définir le update_mask de l'opération, qui indique à l'API Google Ads les attributs à modifier lors de l'opération de mise à jour. Chaque bibliothèque cliente dispose d'une méthode utilitaire ou d'assistance qui génère le update_mask pour vous, comme illustré dans nos bibliothèques clientes.

remove

Supprime la ressource.

Étant donné que le champ operation est un champ oneof, vous ne pouvez pas utiliser une seule opération pour modifier plusieurs objets. Par exemple, si vous souhaitez créer une campagne et en supprimer une autre, ajoutez deux instances de CampaignOperation à votre requête : une avec create défini et une autre avec remove défini.

Opérations par lot

Bien qu'une seule opération ne puisse que créer, mettre à jour ou supprimer une seule ressource, une seule requête de mutation peut contenir plusieurs opérations. Vous devez combiner vos opérations dans une seule requête de mutation au lieu d'envoyer plusieurs requêtes de mutation contenant chacune une seule opération.

Par exemple, si vous souhaitez créer dix campagnes, vous devez envoyer une seule MutateCampaignsRequest comportant dix objets CampaignOperation.

Réponses de mutation

Ce qui est renvoyé dans la réponse dépend de ce qui a été envoyé dans le response_content_type de la requête de mutation. Par exemple, si MUTABLE_RESOURCE a été spécifié, alors la réponse ne contient que les champs modifiables de la campagne. Vous pouvez ensuite effectuer des mutations de suivi sur cet objet de ressource sans avoir à le reconstruire.

Erreurs de mutation

Les opérations d'une requête de mutation donnée ne seront appliquées à votre compte Google Ads que si chaque opération de la requête réussit. Consultez le guide sur les erreurs courantes pour obtenir la liste des erreurs courantes et savoir comment les résoudre.

Suivre les modifications

Pour suivre les modifications apportées aux objets de votre compte Google Ads ou pour récupérer l'état actuel des objets, vous pouvez utiliser les ressources change_status et change_event.

• change_status fournit un résumé des ressources qui ont été modifiées au cours d'une période donnée.
• change_event fournit un historique détaillé des modifications, y compris les anciennes et les nouvelles valeurs des champs modifiés.

Pour interroger ces ressources, utilisez la GoogleAdsService.SearchStream ou GoogleAdsService.Search méthode. En savoir plus sur le streaming de rapports à l'aide de GoogleAdsService.