Die einfachste, aber auch unflexibelste Methode, eine Ressource zu ändern, ist die Verwendung des zugehörigen Dienstes.
Mutate-Endpunkte
Die einfachste Möglichkeit zum Ändern von Ressourcen ist die Verwendung eines ressourcenspezifischen Diensts. Jede veränderliche Ressource hat einen entsprechenden Dienst und eine Reihe von Vorgängen, mit denen Sie die Ressource erstellen, aktualisieren oder entfernen können.
Angenommen, Sie möchten eine neue Campaign
erstellen.
Sie erstellen ein neues Campaign
-Objekt, fügen es in ein CampaignOperation
ein und senden es dann an den Endpunkt CampaignService.MutateCampaigns
.
Das ist für alle Google Ads API-Dienste möglich. Wenn Sie beispielsweise ein AdGroup
ändern möchten, übergeben Sie ein AdGroupOperation
mit dem geänderten AdGroup
an den Endpunkt AdGroupService.MutateAdGroups
.
Wenn Sie eine CampaignCriterion
ändern möchten, verwenden Sie eine CampaignCriterionOperation
und senden sie an den Endpunkt CampaignCriterionService.MutateCampaignCriteria
.
Da das Feld operations
der Anfrage wiederholt werden kann, kann eine einzelne Mutate-Anfrage mehrere Vorgänge enthalten. Jeder Vorgang wird jedoch unabhängig von allen anderen behandelt, sodass keine Querverweise zulässig sind.
Das ist anders als bei der Bulk-Mutationsmethode (GoogleAdsService.Mutate
), bei der in Vorgängen innerhalb derselben Anfrage auf Entitäten aus anderen Vorgängen verwiesen werden kann.