準備
始める前に、次のものが必要になります。
販売パートナー ドメインへの特権管理者のアクセス権。詳細については、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 を有効にします。
サービス アカウントを作成する
サービス アカウントを作成するには、[サービス アカウント] ページに移動します。
- [ サービス アカウントを作成] をクリックします。
- サービス アカウント名(とオプションのサービス アカウントの説明)を入力し、[作成] をクリックします。
- [続行] をクリックして、[サービス アカウントにプロジェクトへのアクセスを許可する] オプションをスキップします。
- [ユーザーにこのサービス アカウントへのアクセスを許可する] セクションをスキップし、[完了] をクリックしてアカウントの作成を完了します。
アカウントを作成したら、サービス アカウント キーを作成します。
- Google Cloud コンソールで、作成したサービス アカウントのメールアドレスをクリックします。
- [キー] をクリックします。
- [鍵を追加]、[新しい鍵を作成] の順にクリックします。
[作成] をクリックします。JSON キーファイルがパソコンにダウンロードされます。
鍵ファイルは、サービス アカウントとしての認証で使用できるため、安全な場所に保管してください。このファイルは任意の場所に移動できます。名前の変更も可能です。
[閉じる] をクリックします。
秘密鍵ファイルは、[サービス アカウント] ページから削除、作成できます。
ステップ 3: 販売パートナー ドメインのサービス アカウントを承認する
このセクションには、サービス アカウントのクライアント ID が必要です。
[アクション] メニューから [詳細を管理] を選択し、[一意の ID] をコピーします。販売パートナー ドメインの特権管理者アカウントを使用して、[ドメイン全体の委任] ページに移動します。
- [新しく追加] をクリックし、[クライアント ID] フィールドにサービス アカウントの ID を入力します。
- [OAuth スコープ] フィールドに「
https://www.googleapis.com/auth/apps.order
」と入力します。 - [承認] をクリックして、チャネル サービス アカウントのコンテキストで Cloud Channel API を使用できるようにサービス アカウントを許可します。
次に、[承認] をクリックして、サービス アカウントがチャネル サービス アカウントのコンテキストで Cloud Channel API を使用できるようにします。
次のステップ
最初の技術的統合が完了したので、Cloud Channel API のドキュメントで API を確認できます。