Service メソッド

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 で最もよく使用されるメソッドです。