Google 広告デベロッパー スターター チェックリスト

このチェックリストでは、Google Ads API のご利用を開始する手順を説明しています。この手順はいくつかのカテゴリに分けられていますが、ニーズに合わない場合はスキップすることもできます。このドキュメントを最大限に活用するには、手順を順番に読んで実行してください。

このリストには、次の 3 種類の項目が含まれています。

Todo: 特定のタスクの実行や、ツールの特定の部分の設定に必要な手順。

チェックリストを印刷する場合は、左側のチェックボックスを使用して、完了したステップをマークできます。このチェックリストは、Google Ads API ドキュメントに記載されている情報を確認する際に推奨される順序です。

アクセスと設定

最上位の MCC アカウントの API センターから開発者トークンを取得します。[API アクセス] フォームのすべての項目を入力し、利用規約に同意する必要があります。指定した API の連絡先メールアドレスが、定期的にモニタリングされている受信トレイに送信されることを確認してください。テスト アカウントのアクセスレベルを持つ開発者トークンが発行されます。

本番環境へのアクセスの承認を受けるには、フォローアップ申請フォームに記入して、API の使用目的を説明する必要があります。

また、設計ドキュメントも提出する必要があります。Google のテンプレートを使用して開始できます。できるだけ詳しく記入してください。

さらに詳しい情報が必要な場合は、Google のトークン審査チームよりご連絡いたしますが、2 営業日以内にフィードバックがなかった場合は、お問い合わせフォームからお問い合わせいただくこともできます。

クライアント ライブラリを設定する

API に対するリクエストの認証には OAuth 2.0 を使用します。OAuth 2.0 ガイドの手順に沿って、OAuth 2.0 の認証情報を設定します。トラブルシューティングには、OAuth 2.0 Playground を使用できます。
Google では、いくつかの一般的なプログラミング言語用のクライアント ライブラリを提供しています。使用する言語のライブラリをダウンロードし、以前に取得した認証情報でライブラリを設定します。

開発者トークン - アクセスレベル

アクセスレベルを確認し、将来的にツールが 1 日あたり 15,000 回を超えるオペレーションを必要とするかどうかを決定します。その場合、無制限の mutate オペレーションを実現する標準アクセスと、1 日あたり GoogleAdsService.Search リクエストおよび GoogleAdsService.SearchStream リクエストを適用する必要があります。ただし、1 日あたり 1,000 件の取得オペレーションの上限が適用されます。
アクセスレベルに応じたオペレーションの計算方法については、レートシートをご覧ください。page_token フィールドが設定された GoogleAdsService.Search リクエストは、オペレーションの上限に対してカウントされません。

必須機能要件（RMF）

必須機能（RMF）をご覧ください。RMF は、ツールの性質に基づいて実装する必要がある一連の関数です。
RMF が正しく実装されていない場合の影響については、違約金をご覧ください。
ツールに適切な RMF が実装されていることを確認してください。
標準権限を申請します。

API を使ってみる

最初の API 呼び出しを行うの手順に沿って、API を使用してキャンペーンを取得する方法を確認します。すべてのオブジェクトは同様の方法で到達可能なため、構造を覚えておくことをおすすめします。
基本的なリソースとサービスの API 構造を理解しておきます。
オブジェクトの変更と検査とオブジェクトの取得をご覧ください。
動的にリクエストする方法については、リソース メタデータをご覧ください。
さまざまなキャンペーンと広告の種類の作成と管理については、キャンペーンの概要をご覧ください。

コードの例

[基本オペレーション] > [キャンペーンの取得]
[基本オペレーション] > [拡張テキスト広告を取得]
[基本オペレーション] > [キャンペーンを追加]
[基本操作] > [キーワードを追加]
[基本オペレーション] > [キーワードの更新]
[キャンペーン管理] > [不承認の広告をすべて取得する]
[キャンペーン管理] > [キャンペーンの入札単価調整比を追加]
[Account Management] > [Get Account Information]
[Account Management] > [Create Customer]
[Account Management] > [Get Account Changes]

レポート

レポートの概要と、GoogleAdsService を Google 広告レポートの信頼できる唯一の情報源として使用した過去 30 日間のアカウントのパフォーマンスをまとめた例を見てみましょう。
Google 広告クエリ言語（GAQL）で、クエリの文法、クエリの構造、リソース、セグメント、指標の概念について理解する。
*_view リソース（KeywordView、TopicView、GenderView など）を使用して、さまざまな条件のパフォーマンス データを取得する方法については、条件の指標をご覧ください。

Google 広告のインタラクティブ クエリビルダー

このツールのエディタでは、特定のリソース（広告グループなど）の Google 広告クエリ言語ステートメントを作成できます。生成された GAQL ステートメントをコピーして、アプリケーションに貼り付けます。

キーワードに関する調査

キーワード プランナーを使い慣れていない方は、Google 広告管理画面のキーワード プランニングの仕組みを確認してみてください。

コードの例

計画のサンプル -> 予測指標の生成
プランニング サンプル -> キーワード候補の生成

予算の自動化

自動支払い、手動支払い、毎月の請求書発行（ご利用限度額）など、Google 広告で利用できる請求オプションについては、お支払い方法と設定をご覧ください。
お支払いプロファイルとお支払いアカウントをプログラムで管理する方法については、お支払い情報の設定をご覧ください。
アカウントに予算が自動的に割り当てられる仕組みについては、アカウントの予算をご覧ください。
Google のビジネス担当者に連絡して、月単位のお支払いへの登録を申請してください。
Google のビジネス担当者に連絡して、AccountBudgetProposalService へのアクセスを申請してください。
AccountBudgetProposal を作成してアカウントに割り当てます。予算とキャンペーン予算を併用してみましょう。

ショッピング広告

Merchant Center アカウントを設定し、MerchantID を取得します。
アプリケーションでご自身の Merchant Center アカウントへのアクセスだけが必要な場合は、サービス アカウント キーを取得します。ただし、クライアントの Merchant Center アカウントにアクセスする必要があるサードパーティ アプリケーションを作成する場合は、OAuth 2.0 を使用したリクエストの承認ガイドをご覧ください。
選択した言語のクライアント ライブラリをダウンロードします。
Java、.NET、PHP、Python などの Content API のコードサンプルを確認します。
Merchant Center アカウントと Google 広告アカウントを手動でリンクする方法を確認する。
Content API を使用して商品リストを設定する方法をご確認ください。
Google Ads API を使用したショッピング キャンペーンの作成ガイドをご覧ください。

推奨事項と変更ステータス

最適化案と変更履歴の機能になじみがない場合は、Google 広告 UI でお試しください。

RecommendationService

Google の最適化案を取得してアカウントに適用し、広告の全体的なパフォーマンスを高めるには、RecommendationService の使用方法に関するガイドをご覧ください。
レコメンデーション機能を検出するには、コードサンプル [最適化案のサンプル] -> [テキスト広告の最適化案の取得] を実行します。

ChangeStatusService

変更履歴を取得して、キャンペーンや広告などのアカウントに対する変更を把握するには、ChangeStatusService の使用方法に関するガイドをご覧ください。
変更履歴の機能を見つけるには、コードサンプル [ChangeStatus Samples] -> [Get Account Changes] を実行します。

最新の状態を維持

バージョニング

新しい API がリリースされたら、最新バージョンのクライアント ライブラリを入手してください。
最新のリリースノートにブックマークを追加して、各バージョンの主な変更点を確認してください。
古いバージョンのクライアント ライブラリの呼び出しを新しいバージョンの呼び出しに置き換えます。
こちらのブログで RSS フィードに登録すると、ブログ記事がメールで届きます。また、フォーラムで Google Ads API に関する最新情報を入手することもできます。
メインの MCC アカウントの API センターに登録されている API の連絡先メールアドレスが最新であることを確認してください。API の使用に関連する技術的な問題が見つかった場合の Google からの連絡はこのメールアドレスに届きます。
Google Merchant Center Google Merchant Center を使用すると、店舗と商品のデータを Google にアップロードして、ショッピング広告やその他の Google サービスで利用できるようになります。
ビジネス プロフィール ビジネス プロフィールを利用すると、Google 検索と Google マップで地域のユーザーに働きかけることができます。
Google アナリティクス Google アナリティクスでは、ユーザーによるウェブサイトの利用状況に関する詳細なレポートを作成できます。 Google アナリティクスを使用すると、広告をクリックした後のユーザー行動を把握できます。
Google タグ マネージャー Google タグ マネージャーは、ウェブサイトやモバイルアプリ上のトラッキング コードと関連するコード（総称して「タグ」）をすばやく簡単に更新できるタグ管理システム（TMS）です。
Google オプティマイズ Google オプティマイズには、小規模ビジネス向けの A/B テスト、ウェブサイトのテスト、パーソナライズ ツールが用意されており、魅力的なカスタマー エクスペリエンスを提供するのに役立ちます。
Google データポータル データポータルでは、データを有益で、読みやすく、共有しやすく、自由にカスタマイズできるダッシュボードとレポートを作成できます。

参考情報

Google Ads API ガイドにブックマークを追加します。ほとんどの基本的なコンセプトは ここで詳しく説明されています
Google Ads API リファレンスにブックマークを追加します。API のすべての機能については、そちらで詳しく説明しています。
Google Ads API のサポートページにブックマークをご登録ください。主なサポート チャネルをご確認いただけます。
Google Ads Developers の YouTube チャンネルをご覧ください。
API に関するより複雑な戦略的問題に対処するためのミーティングについては、Google のビジネス担当者またはパートナー マネージャーにお問い合わせください。