技術的な設定

準備

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

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

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

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

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

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

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

ステップ 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 を使用できるようにサービス アカウントを許可します。

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

次のステップ

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