Google Ads API の設計は従来の REST アーキテクチャと異なる
代わりに search
や mutate,
などのカスタム メソッドを主に使用するため、
従来の list
、get
、create
、update
、delete
メソッドのうちの 1 つ。
これらのアクションは、REST URL で HTTP マッピングを使用して表現されます。
規則を使用してカスタム動詞を URL の残りの部分から分離します。:
たとえば、キャンペーンの変更 API 呼び出しでは次の URL を使用します。
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
API がカスタム メソッドを使用する理由の 1 つは、複数の
単一の API リクエストに統合できます。厳格な REST セマンティクスは、
一度に 1 つずつ更新するとします従来の REST
update
を
たとえば、キャンペーンごとに 1 つの HTTP PATCH リクエストを送信する必要があります。
リソースです。
多くのオペレーションを 1 つのリクエスト本文にまとめるには、
代わりに、Google Ads API では、ほとんどのリソースに対してカスタム mutate
メソッドが定義されています。
同様に、API からのバッチ読み取り(多数のオブジェクトを一度にフェッチ)を有効にするには、
API では、カスタム search
メソッドを使用して SQL に似た Google 広告クエリ
言語。
一般的なメソッドのページでは、 Google Ads API で最もよく使用されるメソッドです。