注意: API の REST インターフェースに関するドキュメントを表示しています。当社の公式クライアント ライブラリのほとんどは gRPC を使用しています。詳しくは、
REST の概要をご覧ください。
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 で最も頻繁に使用されるメソッドについて詳しく説明します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-27 UTC。
[null,null,["最終更新日 2025-08-27 UTC。"],[[["\u003cp\u003eThe Google Ads API utilizes custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003emutate\u003c/code\u003e instead of standard REST methods for efficiency and batch operations.\u003c/p\u003e\n"],["\u003cp\u003eThis approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST.\u003c/p\u003e\n"],["\u003cp\u003eCustom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, \u003ccode\u003ehttps://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBatching operations, like updating many campaigns simultaneously, are enabled through the custom \u003ccode\u003emutate\u003c/code\u003e method, improving efficiency over individual requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esearch\u003c/code\u003e method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call.\u003c/p\u003e\n"]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"],null,["# Service Methods\n\nThe design of the Google Ads API differs from a traditional REST architecture\nbecause it primarily uses custom methods, such as `search` and `mutate,` instead\nof the more traditional `list`, `get`, `create`, `update`, and `delete` methods.\nThese actions are expressed in REST URLs by using the [HTTP mapping](https://cloud.google.com/apis/design/custom_methods#http_mapping)\nconvention of a `:` to separate the custom verb from the rest of the URL.\n\nFor example, a campaign mutate API call uses the following URL: \n\n https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate\n\nOne reason that the API uses custom methods is to enable batching of multiple\noperations into a single API request. Strict REST semantics would only allow\nupdating one campaign at a time. A traditional REST\n[`update`](https://cloud.google.com/apis/design/standard_methods#update) to a\ncampaign, for example, would require sending one HTTP PATCH request per campaign\nresource.\n\nTo allow many operations to be bundled together within a single request body,\nthe Google Ads API instead defines a custom `mutate` method for most resources.\nSimilarly, to enable batch reads (fetching many objects at once) from the API,\nthe API uses a custom `search` method with a SQL-like [Google Ads Query\nLanguage](/google-ads/api/docs/query/overview).\n\nThe [Common methods](/google-ads/api/rest/common/overview) page goes into detail on\nthe most frequently used methods in the Google Ads API."]]
