移行を開始するためのチェックリストは次のとおりです。
AdWords API から Google Ads API へのマッピングを確認します。
以下のツールを確認してください。
更新された利用規約に同意し、API センターで連絡先情報を更新します。
- 開発者トークン(
ads.google.com/aw/apicenter
)がある MCC アカウントの API センターにログインします。 - [API の連絡先メールアドレス] までスクロールして更新します。
- [ビジネス拠点] までスクロールして新しい条件に同意し、[保存] をクリックします。
- 開発者トークン(
Google Cloud プロジェクトで Google Ads API を有効にします。
- Google API Console で API ライブラリを開きます。プロンプトが表示されたら、既存のプロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用可能なすべての API がプロダクト ファミリーと人気度に応じて分類されて表示されます。
- Google Ads API がリストに表示されていない場合は、検索機能を使って見つけます。
- Google Ads API を選択し、[有効にする] ボタンをクリックします。
AdWords API をすでに使用している場合、使用していた認証情報は Google Ads API に対して引き続き有効です。新しい開発者トークンをリクエストしたり、新しい OAuth2
clientId
とclientSecret
のペアを作成したりしないでください。クライアント ライブラリを選択します。
クイックスタートの手順に沿って、最初の呼び出しを行います。
クライアント ライブラリを使用する
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
- IDE で GetCampaigns.java を開いて実行します。
- コンソールにアカウントのキャンペーンの一覧が表示されます。
C#
- IDE で GetCampaigns.cs を開いて実行します。
- コンソールにアカウントのキャンペーンの一覧が表示されます。
PHP
- GetCampaigns.php を実行します。
- コンソールにアカウントのキャンペーンの一覧が表示されます。
Python
- IDE で get_campaigns.py を開いて実行します。
- コンソールにアカウントのキャンペーンの一覧が表示されます。
Ruby
- コマンドラインで「
ruby get_campaigns.rb
」と入力して get_campaigns.rb を実行します。 - コンソールにアカウントのキャンペーンの一覧が表示されます。
Perl
- get_campaigns.pl を実行します。
- コンソールにアカウントのキャンペーンの一覧が表示されます。
コードの例
クライアント ライブラリには、AdWords API から Google Ads API に移行するコード例も用意されています。
クライアント ライブラリの使用に代わる方法
AdWords API をクライアント ライブラリなしで使用していて、Google Ads API でも引き続き使用しない場合でも、認証情報を使用できます。
REST ガイドに移動し、認証情報を使用して Google Ads API に対して HTTP over REST でリクエストを実行する方法を確認してください。