Service メソッド

Google Ads API の設計は、従来の listgetcreateupdatedelete メソッドではなく、主に searchmutate, などのカスタム メソッドを使用するという点で、従来の REST アーキテクチャとは異なります。これらのアクションは REST URL で表現されます。この場合、カスタム動詞を URL の他の部分から分離するために、:HTTP マッピング規則を使用します。

たとえば、campaign mutate API の呼び出しでは次のような URL を使用します

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

API がカスタム メソッドを使用する理由の 1 つは、複数の API リクエストを 1 つの API リクエストにまとめることができるためです。厳格な REST セマンティックでは、一度に 1 つのキャンペーンしか更新できません。たとえば、キャンペーンに対する従来の REST update では、キャンペーン リソースごとに 1 つの HTTP PATCH リクエストを送信する必要があります。

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

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