Changements de service de ressources
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Utiliser le service individuel d'une ressource est le moyen le plus simple de la modifier, mais aussi le moins flexible.
Points de terminaison de mutation
L'utilisation d'un service spécifique aux ressources est la méthode la plus simple pour effectuer une mutation.
Chaque ressource mutable est associée à un service et à un ensemble d'opérations qui vous permettent de créer, de mettre à jour ou de supprimer la ressource.
Supposons que vous souhaitiez créer un Campaign
.
Vous devez créer un objet Campaign
, le placer dans un CampaignOperation
, puis l'envoyer au point de terminaison CampaignService.MutateCampaigns
.
Vous pouvez le faire pour n'importe quel service de l'API Google Ads. Par exemple, si vous souhaitez modifier un AdGroup
, vous devez transmettre un AdGroupOperation
contenant le AdGroup
modifié au point de terminaison AdGroupService.MutateAdGroups
.
De même, si vous souhaitez modifier un CampaignCriterion
, vous devez utiliser un CampaignCriterionOperation
et l'envoyer au point de terminaison CampaignCriterionService.MutateCampaignCriteria
.
Étant donné que le champ operations
de la requête peut être répété, une seule requête mutate peut contenir plusieurs opérations. Toutefois, chaque opération est traitée indépendamment des autres. Aucune référence croisée n'est donc autorisée.
Cela contraste avec la méthode de mutation groupée (GoogleAdsService.Mutate
), où les opérations d'une même requête peuvent faire référence à des entités d'autres opérations.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eThe most straightforward way to mutate a resource is by using its individual service and corresponding operations (create, update, or remove).\u003c/p\u003e\n"],["\u003cp\u003eEach mutable resource has a dedicated service with specific endpoints for mutation, like \u003ccode\u003eCampaignService.MutateCampaigns\u003c/code\u003e for \u003ccode\u003eCampaign\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eA single mutate request to a resource-specific service can handle multiple operations, but each operation is treated independently.\u003c/p\u003e\n"],["\u003cp\u003eResource-specific mutation differs from bulk mutation (\u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e) where operations can cross-reference each other within the same request.\u003c/p\u003e\n"]]],[],null,["# Resource Service Mutates\n\nUsing a resource's individual service is the most straightforward way to mutate\nit, but also the least flexible.\n\nMutate Endpoints\n----------------\n\nUsing a resource-specific service is the most straightforward way to mutate.\nEach mutable resource has a corresponding service and a set of operations that\nenable you to create, update, or remove the resource.\n\nSuppose you want to create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign).\nYou would create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign)\nobject, put it inside a [`CampaignOperation`](/google-ads/api/reference/rpc/v21/CampaignOperation),\nand then send it to the\n[`CampaignService.MutateCampaigns`](/google-ads/api/reference/rpc/v21/CampaignService/MutateCampaigns)\nendpoint.\n\nYou can do this for any of the Google Ads API services. So for example, if you wanted\nto mutate an [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup), you would pass an\n[`AdGroupOperation`](/google-ads/api/reference/rpc/v21/AdGroupOperation) containing the\nmutated [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup) to the\n[`AdGroupService.MutateAdGroups`](/google-ads/api/reference/rpc/v21/AdGroupService/MutateAdGroups) endpoint.\n\nSimilarly, if you want to modify a [`CampaignCriterion`](/google-ads/api/reference/rpc/v21/CampaignCriterion), you would use a\n[`CampaignCriterionOperation`](/google-ads/api/reference/rpc/v21/CampaignCriterionOperation) and send it to the\n[`CampaignCriterionService.MutateCampaignCriteria`](/google-ads/api/reference/rpc/v21/CampaignCriterionService/MutateCampaignCriteria) endpoint.\n\nSince the `operations` field of the request can be repeated, a single mutate\nrequest can contain multiple operations. However, each operation is treated\nindependently from all others, so no cross-referencing is allowed.\n\nThis is in contrast to the bulk mutate method\n([`GoogleAdsService.Mutate`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Mutate)),\nwhere operations within the same request can reference entities from other\noperations."]]