Content API for Shopping の設定には、Google API クライアント ライブラリを使用することをおすすめします。このガイドでは Python Content API クライアント ライブラリを例として使用しますが、これらのライブラリは多くの一般的なプログラミング言語で使用でき、認証、リクエストの送信、レスポンスの解析などの一般的な API タスクを簡素化できます。他の言語のクライアント ライブラリの設定については、GitHub の googleads/googleads-shopping-samples リポジトリ内の README.md をご覧ください。
Python 用 Google API クライアント ライブラリを設定するには、次の手順を完了します。
クライアント ライブラリの構成ファイルと認証ファイル用のディレクトリを作成します。ホーム ディレクトリ内に、次のディレクトリを作成します。
~/shopping-samples/content/
サービス アカウントの認証情報をダウンロードするには、次の手順を完了します。
- Merchant Center の [設定] メニューで、[Content API] を選択します。
- [認証] をクリックします。
- [[+] CREATE API KEY] をクリックします。
- プロンプトが表示されたら、利用規約を読んで同意します。
新しい鍵が自動的にダウンロードされます。
ダウンロードした認証情報ファイルの名前を 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" }
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 で使用できるようになりました。次のセクションでは、新しい商品を挿入するリクエストを作成して送信します。