Service メソッド

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

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

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

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

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

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