Merchant API による自身の販売アカウントへのアクセスを許可するには、サービス アカウントを使用します。アプリがクライアントの販売アカウントにアクセスする必要がある場合は、サードパーティ アプリに販売者アカウントへのアクセスを許可するをご覧ください。
サービス アカウントは特別な種類のアカウントで、通常はユーザーではなくアプリケーションによって使用されます。サービス アカウントは、アカウント固有のメールアドレスで識別されます。
サービス アカウントを作成するには、販売アカウントが必要です。
サービス アカウントを作成する
サービス アカウントの認証情報を生成するか、生成済みの公開認証情報にアクセスして、OAuth 2.0 クライアント ID を作成します。
- Google API Console に移動します。
- ページの上部にあるプルダウン メニューでプロジェクトを選択するか、[新しいプロジェクト] をクリックしてプロジェクトを作成します。
- Google API のリストで Merchant API を検索し、このプロジェクトで API が有効になっていることを確認します。
- [管理] をクリックします。
- 左側のサイドバーで [認証情報] を選択します。[認証情報] が表示されない場合は、ページの左上にある左矢印をクリックします。
- [認証情報を作成]、[サービス アカウント] の順に選択します。
- サービス アカウントに名前を付けます。これは、サービス アカウント ID のデフォルトのユーザー名です。後で使用するために、サービス アカウント ID(@ 文字の後の部分を含む)を保存します。
[作成] をクリックし、プロジェクトとユーザーにアクセス権を付与するオプションの手順を進めて、[完了] をクリックします。
JSON 秘密鍵を取得する
Google API Console で、サービス アカウントの JSON 秘密鍵を生成します。
- サービス アカウントをクリックし、[キー] タブを選択します。
- [鍵を追加] > [新しい鍵を作成] をクリックします。
- 鍵のタイプに [JSON] を選択します。
- [作成] をクリックして秘密鍵をダウンロードします。注: 特権キーは作成時のみダウンロードできます。このステップを後で行うことはできません。
サービス アカウントに販売アカウントへのアクセス権を付与する
新しいサービス アカウントをユーザーとして販売アカウントに追加します。
- Merchant Center にログインします。
- アカウント設定で [アカウントのアクセス] をクリックします。
[+ ユーザーを追加] をクリックし、サービス アカウント ID を新しいユーザーのメールアドレスとして使用します。
サービス アカウント ID を保存していない場合は、[サービス アカウント] 管理ページに移動して、プロジェクトを選択します。
サービス アカウントの [ユーザー アクセス] と [メール通知] の設定を指定します。
[ユーザーを追加] をクリックして設定を保存し、ユーザーのリストに戻ります。選択したユーザーロールとともにサービス アカウント ID が表示されます。
販売アカウントのデータにアクセスする必要があるすべてのサービス アカウントに対して、この手順を繰り返します。
よくある質問
- サービス アカウントで Merchant Center の UI にログインできますか?
- いいえ。サービス アカウントは通常の Google アカウントではないため、Merchant Center UI にはアクセスできません。
- サービス アカウントのアクセス トークンはどのくらいの頻度で更新する必要がありますか?
- アクセス トークンの有効期限は、Google OAuth 2.0 認可サーバーが発行してから 1 時間後です。アクセス トークンの有効期限が切れた場合、アプリケーションはクライアント ライブラリを使用して別のアクセス トークンをフェッチする必要があります。トークンを手動で更新するには、saved-token.json ファイルを削除して再認証します。