Google Ads API には、ユースケースに応じて、リソースを変更するためのいくつかの方法が準備されています。各リソースには、その特定のリソースタイプに対して変更オペレーションを指定できる、対応するサービスがあります。たとえば、Campaign リソースには、変更用キャンペーンに対応する CampaignService.MutateCampaigns エンドポイントがあります。
もう一つのオプションは GoogleAdsService.Mutate エンドポイントです。これは基本的に、リソース サービスでの一連の個別の変更呼び出しをラップし、次のメリットを提供します。
- さまざまなリソース サービスにまたがるアクションをグループ化。通常の呼び出しは、1 つのリソース サービスに対してのみオペレーションを実行できます。
- 一時的なリソース名。オペレーションを組み合わせて、1 つのリクエストでエンティティとその子エンティティを作成します。
この 2 つのプロパティを使用すると、たとえば、GoogleAdsService.Mutate を使用して、すべてのステップが成功する場合にのみキャンペーン構造全体を作成できます。