移行チェックリスト

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

動画ライブラリ: ワークショップ 2021

移行を開始するためのチェックリストは次のとおりです。

  1. AdWords API から Google Ads API へのマッピングを確認します。

  2. 以下のツールを確認してください。

  3. 更新された利用規約に同意し、API センターで連絡先情報を更新します。

    • 開発者トークン(ads.google.com/aw/apicenter)がある MCC アカウントの API センターにログインします。
    • [API の連絡先メールアドレス] までスクロールして更新します。
    • [ビジネス拠点] までスクロールして新しい条件に同意し、[保存] をクリックします。
  4. Google Cloud プロジェクトで Google Ads API を有効にします。

    • Google API Console で API ライブラリを開きます。プロンプトが表示されたら、既存のプロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用可能なすべての API がプロダクト ファミリーと人気度に応じて分類されて表示されます。
    • Google Ads API がリストに表示されていない場合は、検索機能を使って見つけます。
    • Google Ads API を選択し、[有効にする] ボタンをクリックします。
  5. AdWords API をすでに使用している場合、使用していた認証情報は Google Ads API に対して引き続き有効です。新しい開発者トークンをリクエストしたり、新しい OAuth2 clientIdclientSecret のペアを作成したりしないでください。

  6. クライアント ライブラリを選択します。

  7. クイックスタートの手順に沿って、最初の呼び出しを行います。

クライアント ライブラリを使用する

AdWords API クライアント ライブラリを使用していた場合は、いずれかの Google Ads API クライアント ライブラリをダウンロードして、すぐに使用を開始できます。構成ファイルの設定手順については、クライアント ライブラリの README をご覧ください。

ほとんどの場合、AdWords API クライアント ライブラリから Google Ads API クライアント ライブラリに移行すると、既存の構成を再利用できます。重要な違いの 1 つは、新しい login-customer-id です。これを構成に追加する必要がある状況については、ガイドをご覧ください。

Java の設定例

Java クライアント ライブラリの場合は、ads.properties ファイル内の認証情報を指定した行をコピーし、各キーの api.adwords 接頭辞を api.googleads に変更します。

api.adwords.clientId       --> api.googleads.clientId
api.adwords.clientSecret   --> api.googleads.clientSecret
api.adwords.refreshToken   --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken

構成ファイルを更新したら、最初の呼び出しに進むことができます。

Java

  1. IDE で GetCampaigns.java を開いて実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

C#

  1. IDE で GetCampaigns.cs を開いて実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

PHP

  1. GetCampaigns.php を実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

Python

  1. IDE で get_campaigns.py を開いて実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

Ruby

  1. コマンドラインで「
    ruby get_campaigns.rb
    」と入力して get_campaigns.rb を実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

Perl

  1. get_campaigns.pl を実行します。
  2. コンソールにアカウントのキャンペーンの一覧が表示されます。

コードの例

クライアント ライブラリには、AdWords API から Google Ads API に移行するコード例も用意されています。

Java

移行の例

C#

移行の例

PHP

移行の例

Python

移行の例

Ruby

移行の例

Perl

移行の例

クライアント ライブラリの使用に代わる方法

AdWords API をクライアント ライブラリなしで使用していて、Google Ads API でも引き続き使用しない場合でも、認証情報を使用できます。

REST ガイドに移動し、認証情報を使用して Google Ads API に対して HTTP over REST でリクエストを実行する方法を確認してください。