技術的な設定

準備

始める前に、次のものが必要になります。

• 販売パートナー ドメインへの特権管理者のアクセス権。詳細については、Cloud Channel API へアクセスする方法をご覧ください。

• Google Cloud コンソールと Partner Sales Console へのアクセス権。

ステップ 1: Partner Sales Console を準備する

API を使用する前に、チャネル サービス プラットフォームの利用規約に同意する必要があります。

販売パートナー ドメインの管理者として少なくとも 1 回 Partner Sales Console にログインします。初めてログインする場合は、販売パートナーの利用規約に同意する必要があります。特定の利用規約にオフラインで同意した場合は、この手順は適用されません。

Partner Sales Console の [利用規約] ページで、追加の利用規約に同意できます。

注: API を統合するには、Partner Sales Console の [設定] ページにあるアカウント ID が必要です。

ステップ 2: Google Cloud プロジェクトを構成する

Google API を使用するには、Google Cloud プロジェクトが必要です。

Google Cloud プロジェクトを作成する

プロジェクトを作成するには、Google Cloud コンソールの [プロジェクト] 領域に移動して、 [プロジェクトを作成] をクリックします。

プロジェクトの作成手順とベスト プラクティスの一覧については、プロジェクトの作成と管理ガイドをご覧ください。

ほとんどの販売パートナーは、販売パートナー ドメインではなく、メインの Google Cloud 組織の下に Google Cloud プロジェクトを作成します。販売パートナー ドメインからデータにアクセスするには、サービス アカウントが販売パートナー ドメインからデータにアクセスできるように、ドメイン全体の委任を設定します。

プロジェクトにわかりやすい名前を付けます。プロジェクト ID は、Cloud Channel API の呼び出し機能に影響しない任意の識別子です。

API を有効にする

Google Cloud コンソールで [API ライブラリ] セクションに移動し、Cloud Channel API を有効にします。

サービス アカウントを作成する

サービス アカウントを作成するには、[サービス アカウント] ページに移動します。

[サービス アカウント] に移動

注: サービス アカウント キーが正しく管理されていない場合は、セキュリティ リスクが発生します。可能であれば、サービス アカウント キーよりも安全な代替手段を選択してください。サービス アカウント キーで認証する必要がある場合は、秘密鍵のセキュリティと、サービス アカウント キーを管理するためのベスト プラクティスで説明されているその他の操作は、ユーザーの責任で実施してください。サービス アカウント キーを作成できない場合は、組織でサービス アカウント キーの作成が無効になっている可能性があります。詳細については、デフォルトで安全な組織リソースの管理をご覧ください。

1. [ サービス アカウントを作成] をクリックします。
2. サービス アカウント名（とオプションのサービス アカウントの説明）を入力し、[作成] をクリックします。
3. [続行] をクリックして、[サービス アカウントにプロジェクトへのアクセスを許可する] オプションをスキップします。
4. [ユーザーにこのサービス アカウントへのアクセスを許可する] セクションをスキップし、[完了] をクリックしてアカウントの作成を完了します。

アカウントを作成したら、サービス アカウント キーを作成します。

1. Google Cloud コンソールで、作成したサービス アカウントのメールアドレスをクリックします。
2. [キー] をクリックします。
3. [鍵を追加]、[新しい鍵を作成] の順にクリックします。

4. [作成] をクリックします。JSON キーファイルがパソコンにダウンロードされます。

   鍵ファイルは、サービス アカウントとしての認証で使用できるため、安全な場所に保管してください。このファイルは任意の場所に移動できます。名前の変更も可能です。

5. [閉じる] をクリックします。

秘密鍵ファイルは、[サービス アカウント] ページから削除、作成できます。

ステップ 3: 販売パートナー ドメインのサービス アカウントを承認する

このセクションには、サービス アカウントのクライアント ID が必要です。 [アクション] メニューから [詳細を管理] を選択し、[一意の ID] をコピーします。

販売パートナー ドメインの特権管理者アカウントを使用して、[ドメイン全体の委任] ページに移動します。

• [新しく追加] をクリックし、[クライアント ID] フィールドにサービス アカウントの ID を入力します。
• [OAuth スコープ] フィールドに「https://www.googleapis.com/auth/apps.order」と入力します。
• [承認] をクリックして、チャネル サービス アカウントのコンテキストで Cloud Channel API を使用できるようにサービス アカウントを許可します。

注: 最終的な統合で追加の API を使用する場合、サービス アカウントのクライアントに複数のスコープが存在することがあります。

次に、[承認] をクリックして、サービス アカウントがチャネル サービス アカウントのコンテキストで Cloud Channel API を使用できるようにします。

注: 他の Codelab で、より多くの API を有効にしてスコープを追加する必要がある場合があります。 最終的な統合には、サービス アカウントのクライアントに複数のスコープが含まれる場合があります。

次のステップ

最初の技術的統合が完了したので、Cloud Channel API のドキュメントで API を確認できます。

注: Test Partner Sales Console もお持ちの場合は、テスト用の販売パートナー ドメインでステップ 1 ～ 4 を行ってください。Google API にはプロジェクトごとの割り当てがあるため、個別のプロジェクトを作成してください。環境間でプロジェクトを共有すると、テスト アカウントが本番環境アカウントの割り当てに影響する場合があります。