移行チェックリスト

video_library 動画ライブラリ: ワークショップ 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 clientId と clientSecret のペアを作成したりしないでください。

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

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

コードの例

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

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

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

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