はじめに
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Google Ads API は、大規模または複雑な Google 広告アカウントやキャンペーンの管理に使用されます。顧客単位からキーワード単位まで、さまざまな方法でアカウントを管理するソフトウェアを作成することができます。一般的なユースケースは次のとおりです。
- アカウント管理の自動化
- カスタム レポートの作成
- 商品の在庫に合わせた広告の管理
- スマート自動入札戦略を管理する
Google Ads API は自分に適したサービスか?
Google では、Google 広告アカウントの自動化に役立つ複数のサービスを提供しています。一般的なシナリオと、ニーズに最適な Google サービスの一覧を以下に示します。
シナリオ |
推奨事項 |
独自のソフトウェア プロダクトを構築したい、または Google Ads API と統合したいデベロッパーです。コードの作成、サーバーやデータベースなどのソフトウェア インフラストラクチャの管理に慣れている。 |
Google Ads API を使用します。 |
コードの作成には慣れていますが、独自のソフトウェア インフラストラクチャの管理は避けたいと考えているデベロッパー。 |
Google 広告スクリプトを使用します。 |
私はデベロッパーではありませんが、Google 広告を自動化するためにプログラミングを学ぶことに時間を費やしても構いません。 |
Google 広告スクリプトを使用します。 |
データ アナリスト(または同様の役割)として、詳細な分析のために Google 広告レポートをダウンロードしたい。 |
BigQuery Data Transfer Service を使用します。
Google 広告の転送についてはサポートをご利用いただけます。 |
Google 広告を一括で管理したいのですが、コードは記述したくありません。 |
自動化ルール、一括アップロード、または Google 広告エディタを使用します。 |
前提条件
Google Ads API 呼び出しを行うには、次の詳細情報が必要です。このチュートリアルの残りの部分では、これらの各アイテムを取得する方法について説明します。
- Google 広告クライアント センター(MCC)アカウント: Google Ads API を申請するには、Google 広告クライアント センター(MCC)アカウントが必要です。
デベロッパー トークン: このトークンを使用すると、アプリを Google Ads API に接続できます。各デベロッパー トークンには API アクセスレベルが割り当てられます。このレベルによって、1 日あたりに実行できる API 呼び出しの数と、呼び出しを実行できる環境が制御されます。
Google API Console プロジェクト: Google API Console プロジェクトは、アプリの OAuth 2.0 認証情報の生成に使用されます。アプリはこれらの認証情報を使用してユーザーを認証し、ユーザーの Google 広告アカウントを管理するためのユーザー認証を取得します。この承認は、後でアプリが Google 広告アカウントに API 呼び出しを行う際に使用されます。また、プロジェクトで API が呼び出しを受け入れるようにします。
Google 広告クライアント アカウント: API 呼び出しを行うアカウントです。このアカウントでレポートの取得やキャンペーンの変更などの操作を行うには、必要な権限が必要です。
また、API 呼び出しを行うアカウントの 10 桁のアカウント番号も必要です。これは Google 広告のウェブ インターフェースに 123-456-7890
の形式で表示されます。このアカウント番号は、ハイフンなしで 1234567890
として Google Ads API 呼び出しにパラメータとして渡されます。
サポートツールとクライアント ライブラリ: このツールセットを使用すると、API との統合をより迅速に行うことができます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 2025-08-31 UTC。"],[[["\u003cp\u003eThe Google Ads API is designed for managing large or complex Google Ads accounts programmatically, enabling tasks like automated account management, custom reporting, and inventory-based ad management.\u003c/p\u003e\n"],["\u003cp\u003eGoogle offers alternative solutions like Google Ads scripts, BigQuery Data Transfer service, automated rules, bulk uploads, and Google Ads Editor depending on user technical expertise and needs.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Google Ads API, you'll need a Google Ads manager account, a developer token, a Google API Console project, and access to a Google Ads client account with necessary permissions.\u003c/p\u003e\n"],["\u003cp\u003eBefore making API calls, ensure you have the required details, including the 10-digit Google Ads client account number (without hyphens) and support tools or client libraries.\u003c/p\u003e\n"]]],[],null,["# Introduction\n\nThe Google Ads API is used for managing large or complex Google Ads accounts and\ncampaigns. You can build software that manages accounts from the customer level\ndown to the keyword level. Some typical use cases include:\n\n- Automated account management\n- Custom reporting\n- Ad management based on inventory\n- Manage smart bidding strategies\n\nIs the Google Ads API the right product for me?\n-----------------------------------------------\n\nGoogle provides multiple products to help automate Google Ads accounts. Here are\nsome common scenarios and the list of Google products that might best\nfit your needs.\n\n| Scenario | Recommendation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| I am a developer who wishes to build my own software product, or integrate with Google Ads API. I am comfortable writing code, managing software infrastructure including servers and database. | Use the Google Ads API. |\n| I am a developer who is comfortable writing code, but prefer not to manage my own software infrastructure. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am not a developer, but am willing to invest some time learning programming to automate Google Ads. | Use [Google Ads scripts](/google-ads/scripts). |\n| I am a data analyst (or similar role) who wants to download Google Ads reports for further analysis. | Use [BigQuery Data Transfer service](//cloud.google.com/bigquery/docs/dts-introduction). Support is available for [Google Ads transfers](//cloud.google.com/bigquery/docs/google-ads-transfer). |\n| I want to manage Google Ads in bulk, but don't want to write any code. | Use [automated rules](//support.google.com/google-ads/answer/2472779), [bulk uploads](//support.google.com/google-ads/answer/10702932), or [Google Ads Editor](//support.google.com/google-ads/editor/answer/2484521). |\n\nPrerequisites\n-------------\n\nTo make a Google Ads API call, you should have the following details. The rest of this\ntutorial teaches you how to obtain each of these items.\n\n- [**Google Ads manager account**](//support.google.com/google-ads/answer/7459399): You need a Google Ads manager account to apply for the Google Ads API.\n- [**Developer token**](/google-ads/api/docs/get-started/dev-token): This token lets your app connect to the\n Google Ads API. Each developer token is assigned an API access level which\n controls the number of API calls you can make per day with as well as the\n environment to which you can make calls.\n\n- [**Google API Console project**](/google-ads/api/docs/get-started/oauth-cloud-project): The Google API Console project is used\n for generating OAuth 2.0 credentials for your app. The app will then use\n these credentials to authenticate the user and obtain user authorization to\n manage their Google Ads accounts. This authorization is later used by your app\n to make API calls to the Google Ads account. The project also enables the API\n to accept calls.\n\n- [**Google Ads client account**](/google-ads/api/docs/get-started/select-account): This is the account you're making API\n calls against. You need necessary permissions to operate on this account,\n such as fetching reports or making changes to campaigns.\n\n You also need the 10-digit account number of the account you're making API\n calls to. This is displayed in the Google Ads web interface in the form\n `123-456-7890`. This account number is passed as a parameter to the Google Ads API\n call without the hyphens: `1234567890`.\n- [**Support tools and client libraries**](/google-ads/api/docs/get-started/download-tools-libraries): This set of tools can help\n you integrate with the API more quickly."]]