Service メソッド

Google Ads API の設計は、従来の REST アーキテクチャとは異なります。主に、従来の list、get、create、update、delete メソッドではなく、search や mutate, などのカスタム メソッドを使用しているためです。これらのアクションは、: の HTTP マッピング規則を使用して、カスタム動詞を URL の残りの部分から分離することで、REST URL で表されます。

たとえば、キャンペーンの変更 API 呼び出しでは次の URL が使用されます。

https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate

API がカスタム メソッドを使用する理由の 1 つは、複数のオペレーションを 1 つの API リクエストにバッチ処理できるようにするためです。厳密な REST セマンティクスでは、一度に更新できるキャンペーンは 1 つのみです。たとえば、キャンペーンへの従来の REST update では、キャンペーン リソースごとに 1 つの HTTP PATCH リクエストを送信する必要があります。

多くのオペレーションを 1 つのリクエスト本文にまとめることができるように、Google Ads API では、ほとんどのリソースにカスタム mutate メソッドが定義されています。同様に、API からのバッチ読み取り（複数のオブジェクトを一度に取得）を有効にするために、API は SQL に似た Google 広告クエリ言語でカスタム search メソッドを使用します。

一般的なメソッドのページでは、Google 広告 API で最もよく使用されるメソッドについて詳しく説明しています。