Mutating Resources

  • The Google Ads API offers resource-specific services and the GoogleAdsService.Mutate endpoint for modifying resources.

  • GoogleAdsService.Mutate enables grouped actions across various resource services and supports temporary resource names for creating entities and their children in one request.

  • While resource-specific services handle mutations for their resource type, GoogleAdsService.Mutate provides flexibility for complex operations, ensuring all steps succeed.

  • Cross-account mutations are generally prohibited, with exceptions for manager accounts acting on client-created objects.

The Google Ads API provides a few different ways for mutating resources, depending on your use case. Each resource has a corresponding service that lets you specify mutate operations for that specific resource type. For example, the Campaign resource has a corresponding CampaignService.MutateCampaigns endpoint for mutating campaigns.

Another option is the GoogleAdsService.Mutate endpoint, which essentially wraps a series of individual mutate calls on the resource services and provides the following benefits:

  • Grouped actions across different resource services. Normal calls can only execute operations against a single resource service.
  • Temporary resource names. Combine operations to create an entity and its child entities in a single request.

With these two properties, you can use GoogleAdsService.Mutate to, for example, create an entire campaign structure only if every step along the way succeeds.

Next
Resource mutates