Google Ads API の設計は、従来の list
、get
、create
、update
、delete
メソッドではなく、主に search
や mutate,
などのカスタム メソッドを使用するという点で、従来の REST アーキテクチャとは異なります。これらのアクションは REST URL で表現されます。この場合、カスタム動詞を URL の他の部分から分離するために、:
の HTTP マッピング規則を使用します。
たとえば、campaign mutate API の呼び出しでは次のような URL を使用します
https://googleads.googleapis.com/v17/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 で最もよく使用されるメソッドについて詳しく説明します。