Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A Google Ads API oferece algumas maneiras diferentes de modificar recursos, dependendo do seu caso de uso. Cada recurso tem um serviço correspondente que permite
especificar operações de modificação para esse tipo de recurso específico. Por exemplo, o recurso
Campaign tem um endpoint
CampaignService.MutateCampaigns
correspondente para modificar campanhas.
Ações agrupadas em diferentes serviços de recursos. As chamadas normais só podem
executar operações em um único serviço de recursos.
Nomes de recursos temporários. Combine as operações para criar uma entidade e as entidades filhas dela em uma única solicitação.
Com essas duas propriedades, você pode usar GoogleAdsService.Mutate para, por exemplo, criar uma estrutura de campanha inteira somente se todas as etapas do caminho tiverem sucesso.
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads API offers resource-specific services and the \u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e endpoint for modifying resources.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e enables grouped actions across various resource services and supports temporary resource names for creating entities and their children in one request.\u003c/p\u003e\n"],["\u003cp\u003eWhile resource-specific services handle mutations for their resource type, \u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e provides flexibility for complex operations, ensuring all steps succeed.\u003c/p\u003e\n"],["\u003cp\u003eCross-account mutations are generally prohibited, with exceptions for manager accounts acting on client-created objects.\u003c/p\u003e\n"]]],[],null,["# Mutating Resources\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe Google Ads API provides a few different ways for mutating resources, depending on\nyour use case. Each resource has a corresponding service that lets you\nspecify mutate operations for that specific resource type. For example, the\n`Campaign` resource has a corresponding\n[`CampaignService.MutateCampaigns`](/google-ads/api/reference/rpc/v21/CampaignService/MutateCampaigns)\nendpoint for mutating campaigns.\n\nAnother option is the\n[`GoogleAdsService.Mutate`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Mutate) endpoint,\nwhich essentially wraps a series of individual mutate calls on the resource\nservices and [provides the following benefits](/google-ads/api/docs/mutating/best-practices):\n\n- **Grouped actions across different resource services.** Normal calls can only execute operations against a single resource service.\n- **Temporary resource names.** Combine operations to create an entity and its child entities in a single request.\n\nWith these two properties, you can use\n[`GoogleAdsService.Mutate`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Mutate) to, for\nexample, create an entire campaign structure only if every step along the way\nsucceeds.\n| **Key Point:** Generally, cross-account mutating is not allowed; an account cannot mutate objects that it didn't create, unless it is the manager of the client that created the object."]]
