Google API クライアント ライブラリを使用して Content API for Shopping を設定することをおすすめします。このガイドでは、Python Content API クライアント ライブラリを例として使用しますが、多くの一般的なプログラミング言語で使用でき、認証、リクエストの送信、レスポンスの解析などの一般的な API タスクを簡素化できます。他の言語のクライアント ライブラリの設定については、GitHub の googleads/googleads-shopping-samples リポジトリにある言語の README.md をご覧ください。
Python 用 Google API クライアント ライブラリを設定する手順は次のとおりです。
クライアント ライブラリの構成ファイルと認証ファイル用のディレクトリを作成します。ホーム ディレクトリに次のディレクトリを作成します。
~/shopping-samples/content/
サービス アカウントの認証情報をダウンロードする手順は次のとおりです。
- Google API ライブラリに移動します。
- ページ上部のメニューでプロジェクトを選択します。まだプロジェクトがない場合は、[新しいプロジェクト] をクリックして作成します。
- このプロジェクトで Content API for Shopping をまだ有効にしていない場合は、Google API のリストで検索して有効にします。
- 左上のナビゲーション メニュー（☰）をクリックし、[API とサービス]、[認証情報] の順に選択します。
- サービス アカウントを設定するには、[認証情報を作成]、 [サービス アカウント] の順に選択します。
- 新しいサービス アカウントに名前を付けます。これは、サービス アカウント ID のデフォルトのユーザー名としても使用されます。後で使用するために、'@' 文字以降を含むサービス アカウント ID を記録します。[作成] をクリックし、プロジェクトとユーザーへのアクセス権の付与の手順（省略可）を行い、[完了] をクリックします。
- [サービス アカウント] ページに移動し、新しいサービス アカウントにアクセスできます。
JSON 秘密鍵を取得するには、サービス アカウントをクリックし、[鍵] タブをクリックします。[鍵を追加] > [新しい鍵を作成] をクリックし、 鍵の種類として [JSON] を選択します。[作成] をクリックして、秘密鍵をパソコンにダウンロードします。 新しい鍵が自動的にダウンロードされます。
ダウンロードした認証情報ファイルの名前を「service-account.json 」に変更します。
service-account.json ファイルを home directory/shopping-samples/content/ に移動します。
home directory/shopping-samples/content/ に、 空の merchant-info.json ファイルを作成します。
merchant-info.json に次のテキストを追加します。
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }新しいサービス アカウントをユーザーとして Merchant Center アカウントに追加します。サードパーティ デベロッパーの場合は、クライアントにこの手順を行ってもらう必要があります。
- Merchant Center アカウントに移動します。
- Merchant Center アカウントの設定で、[ユーザーとアクセス] を選択します。
[+ ユーザーを追加] をクリックし、新しいユーザーのメールアドレスとしてサービス アカウント ID を使用します。
Accountsサービスを使用するには管理者アクセス権が必要なため、[管理者] を選択します。[ユーザーを追加] をクリックして設定を保存し、ユーザーのリストに戻ります。サービス アカウント ID が、選択したユーザーのロールとともに表示されます。
追加する他のすべてのサービス アカウントについて、この手順を繰り返します。
googleads/googleads-shopping-samples GitHub リポジトリをパソコンの任意の場所にクローン（またはダウンロードして解凍）します。 ホーム ディレクトリまたは ~/shopping-samples/content/ に配置する必要はありません。
リポジトリをクローンするのではなくダウンロードして解凍した場合は、解凍したディレクトリの名前を「googleads-shopping-samples 」に変更します。
必要なサンプル依存関係をインストールするには、ターミナル ウィンドウで googleads-shopping-samples/python/ に移動して、次のコマンドを実行します。
pip install -r requirements.txt
これで、Python 用 Google API クライアント ライブラリが構成され、Content API で使用できるようになりました。次のセクションでは、新しい商品を挿入するリクエストを作成して送信します。