クライアント ライブラリを設定する

Content API for Shopping を設定するには、Google API クライアント ライブラリを使用することをおすすめします。このガイドでは、Python Content API クライアント ライブラリを例として使用しますが、これらのライブラリは多くの一般的なプログラミング言語で使用でき、認証、リクエストの送信、レスポンスの解析などの一般的な API タスクを簡素化します。他の言語のクライアント ライブラリの設定については、GitHub の googleads/googleads-shopping-samples リポジトリ内にある、その言語の README.md をご覧ください。

Python 用 Google API クライアント ライブラリを設定するには、次の手順を完了します。

1. クライアント ライブラリの構成ファイルと認証ファイル用のディレクトリを作成します。ホーム ディレクトリ内に次のディレクトリを作成します。

   ~/shopping-samples/content/

2. サービス アカウントの認証情報をダウンロードする手順は次のとおりです。

   1. Google API ライブラリに移動します。
   2. ページ上部のメニューでプロジェクトを選択します。まだプロジェクトがない場合は、[新しいプロジェクト] をクリックして作成します。
   3. このプロジェクトで Content API for Shopping をまだ有効にしていない場合は、Google API のリストで検索して有効にします。
   4. 左側のサイドバーで [認証情報] を選択します。左上の左矢印をクリックして表示する必要があります。
   5. サービス アカウントを設定するには、[認証情報を作成]、[サービス アカウント] の順に選択します。
   6. 新しいサービス アカウントに名前を付けます。これは、サービス アカウント ID のデフォルトのユーザー名としても機能します。後で使用できるように、サービス アカウント ID（「@」文字の後の部分を含む）を記録します。[作成] をクリックし、プロジェクトとユーザーへのアクセス権を付与するオプションの手順を行い、[完了] をクリックします。
   7. [サービス アカウント] ページが表示され、新しいサービス アカウントにアクセスできるようになります。

3. JSON 秘密鍵を取得するには、サービス アカウントをクリックし、[キー] タブをクリックします。[鍵を追加] > [新しい鍵を作成] をクリックし、鍵のタイプとして JSON を選択します。[作成] をクリックして、秘密鍵をパソコンにダウンロードします。新しいキーが自動的にダウンロードされます。

4. ダウンロードした認証情報ファイルの名前を service-account.json に変更します。

5. service-account.json ファイルを home directory/shopping-samples/content/ に移動します。

6. home directory/shopping-samples/content/ に、空の merchant-info.json ファイルを作成します。

7. merchant-info.json に次のテキストを追加します。

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. 新しいサービス アカウントをユーザーとして Merchant Center アカウントに追加します。サードパーティ デベロッパーの場合は、クライアントにこの手順を依頼する必要があります。

   1. Merchant Center アカウントに移動します。
   2. Merchant Center アカウントの設定で、[ユーザーとアクセス] を選択します。

   3. [+ ユーザーを追加] をクリックし、新しいユーザーのメールアドレスとしてサービス アカウント ID を使用します。

   4. Accounts サービスを使用するには管理者権限が必要であるため、[管理者] を選択します。

   5. [ユーザーを追加] をクリックして設定を保存し、ユーザーのリストに戻ります。選択したユーザーロールとともにサービス アカウント ID が表示されます。

   6. 追加する他のすべてのサービス アカウントに対してこの手順を繰り返します。

9. googleads/googleads-shopping-samples GitHub リポジトリのクローンを作成するか、ダウンロードして解凍し、任意の場所に配置します。ホーム ディレクトリや ~/shopping-samples/content/ に配置する必要はありません。

10. リポジトリをダウンロードして解凍した場合は、クローンを作成するのではなく、解凍したディレクトリの名前を googleads-shopping-samples に変更します。

11. 必要なサンプルの依存関係をインストールするには、ターミナル ウィンドウで googleads-shopping-samples/python/ に移動し、次のコマンドを実行します。

    pip install -r requirements.txt
    

これで、Python 用 Google API クライアント ライブラリが構成され、Content API で使用できるようになりました。次のセクションでは、新しい商品を挿入するリクエストを作成して送信します。