Google Ads API に Google API Console プロジェクトを設定する

Google の OAuth2 サーバーにアクセスするための認証情報は、Google 広告ユーザーを認証したり承認したりするために必要です。これらの認証情報により、 OAuth トークンを生成して Google 広告を管理するための できます。Google OAuth2 認証情報へのアクセスは、Google API Console で管理されています。

Cloud プロジェクトのベスト プラクティスに関する動画

Google OAuth の確認

Google Ads API スコープの認証情報を取得するために使用する Google Cloud アプリには、 Google OAuth 2.0 の認証を受けるために 確認して そのアプリの未検証の UI 画面 できます。この場合、アプリは、一意の OAuth 2.0 クライアント ID として定義されます。 説明します。

この検証は独立したものであり、 開発者トークン承認プロセスの一環 Google Ads API のスコープは機密事項である あります

Google による適格性確認の費用はかかりません。通常、適格性確認は 3 5 営業日ほどかかります。このポリシーはすべてのアプリに適用されます。

すべてのアプリについて、なるべく早く Google OAuth 確認プロセスを実施することをおすすめします。 可能な限り対応をお願いします

プロジェクトを作成する

Google API Console に移動します。[プロジェクトを作成] をクリックします。 名前を入力して [作成] をクリックします。

プロジェクトで Google Ads API を有効にする

プロジェクトで Google Ads API を有効にする手順は次のとおりです。

  1. Google API コンソールで API ライブラリを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。

  2. リストに表示されない場合は、検索を使用して Google Ads API を見つけます。

  3. API を選択し、[有効にする] ボタンをクリックします。

ユーザータイプと公開ステータスを選択する

API を有効にしたら、プロジェクトのユーザーの種類公開ステータス。次の表に、主な属性と 制限事項があります。詳しくは Google Cloud Platform ドキュメントをご覧ください

ユーザーの種類 公開ステータス 制限事項
内部 テスト
  • Google Cloud に関連付けられたプロジェクトでのみ使用できます。 整理。
  • OAuth 同意リストに含まれるテストユーザーは最大 100 人に制限されています 表示されます。
  • テストユーザーは Google Cloud の内部ユーザーであること プロジェクトに関連付けられている組織。
  • 承認は、同意後 7 日間有効です。
外部 テスト
  • すべてのプロジェクトで使用できます。
  • OAuth 同意リストに含まれるテストユーザーは最大 100 人に制限されています 表示されます。
  • テストユーザーは、Google アカウントを持つ任意のユーザーです。
  • 承認は、同意後 7 日間有効です。
内部 本番環境
  • Google Cloud に関連付けられたプロジェクトでのみ使用できます。 整理。
  • Google Cloud 組織内のすべてのユーザーを承認できる 関連付けられます。
外部 本番環境
  • すべてのプロジェクトで使用できます。
  • Google アカウントを持つ任意のユーザーの認証を許可します。

Google OAuth の オーナー確認 ユーザーの種類公開状況にかかわらず、 ステータスが表示されます。

  1. アプリ 同意画面ページ ページの上部にあるプルダウン メニューでプロジェクトを選択します。

  2. [ユーザーの種類] を選択し、[作成] をクリックします。

  3. 同意画面フォームに入力します。これは、必要に応じて後で編集できます。[ 完了したら [保存して次へ] をクリックします。

  4. 次のページで、[スコープを追加または削除] をクリックします。

    • 下にスクロールして、[手動で追加] の下のフィールドに次のように入力します。 スコープ:

      https://www.googleapis.com/auth/adwords
      
    • [表に追加] をクリックします。

    • プロジェクトでリクエストする他のスコープを追加し、[更新] をクリックします。

    • [保存して次へ] をクリックします。

  5. プロジェクトをすぐに公開しない場合は、メールアドレスを追加してください ユーザー アカウントを選択して [保存して 続行

  6. 概要ページを確認し、[ダッシュボードに戻る] をクリックします。

申請と承認プロセスをテストしたら、 ダッシュボードに戻り、[アプリを公開] をクリックして [公開 ステータステストから本番環境に変更します。

アプリの種類を選択する

Google Ads API には、PC とウェブの 2 種類のアプリタイプ オプションがあります。詳しくは、 次の表で、使用するアプリに最も適したタイプを判断してください 構築します。

アプリケーションのタイプ 適しているケース
デスクトップ アプリ
  • すべての Google 広告アカウントを 1 つのトップレベルで管理している クライアント センター(MCC)アカウント。
  • API をはじめて利用する場合や、簡単な設定ですぐに利用を開始したい場合
  • アプリは 1 台のマシンからのみ Google ユーザーを認証します。
ウェブアプリ
  • アプリケーションに Google 広告アカウントのデータへのアクセスを許可するユーザーとして認証を行う場合
  • 複数の認証情報を簡単に生成して、サードパーティなどのアカウントを管理したい場合
  • アプリにコールバック URL が必要です。コールバック URL は、 確認しましょう。

詳細については、Google Identity Platform の OAuth に関するドキュメントを デスクトップ アプリ ウェブアプリ

クライアント ID とクライアント シークレットを作成する

アプリケーションのタイプが決まったら、次の手順に沿って OAuth2 クライアント ID とクライアント シークレットを生成します。

  1. [認証情報] ページを開きます。 以前に作成したプロジェクトを選択するか、新しいプロジェクトを作成します。

  2. [認証情報] 画面で [認証情報を作成] をクリックし、[OAuth] を選択します。 クライアント ID

    1. このプロジェクトで OAuth 同意画面を構成していない場合 今から行うように求められます。[ 同意画面を構成します。

      1. ユーザータイプを選択し、[作成] をクリックします。

      2. 最初のフォームに入力します。これは、必要に応じて後で編集できます。[ 完了したら [保存] をクリックします。

    2. [認証情報] >認証情報を作成 >OAuth クライアント ID ] をクリックしてください。

  3. アプリの種類として [デスクトップ アプリ] または [ウェブ アプリケーション] を選択します。 ユースケースに応じて使い分けることができます

  4. 名前を付けて [作成] をクリックします。

  5. クライアントの種類がウェブ アプリケーションの場合は、承認済み 指定します。

    Google のデフォルト設定と互換性のあるローカルテストの場合、 クライアント ライブラリの例では、http://127.0.0.1 を使用してください。

    デスクトップ アプリ クライアントの場合は、引き続き ループバック IP リダイレクト、 URI は Cloud コンソールで明示的に構成されていません。

  6. 確認ページで [クライアント ID] と [クライアント シークレット] をコピーします。 クリップボードにコピーできます。クライアントの構成時に必要になります。 ライブラリです。後で認証情報ページに戻って、これらの認証情報を取得することもできます。 表示されます。