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 リクエストを送信する必要があります。
多くのオペレーションを 1 つのリクエスト本文にまとめることができるように、Google Ads API では、ほとんどのリソースにカスタム mutate
メソッドが定義されています。同様に、API からのバッチ読み取り(複数のオブジェクトを一度に取得)を有効にするために、API は SQL に似た Google 広告クエリ言語でカスタム search
メソッドを使用します。
一般的なメソッドのページでは、Google 広告 API で最もよく使用されるメソッドについて詳しく説明しています。