始める前に
始める前に、次のものが必要になります。
販売パートナー ドメインへの特権管理者のアクセス権。詳細については、Cloud Channel API へアクセスする方法をご覧ください。
Google Cloud コンソールとパートナー セールス コンソールにアクセスする。
ステップ 1: Partner Sales Console を準備する
API を使用する前に、チャネル サービス プラットフォームの利用規約に同意する必要があります。
販売パートナー ドメインの管理者として Partner Sales Console に少なくとも 1 回ログインします。初めてログインする場合は、販売パートナーの利用規約に同意する必要があります（該当する場合）。特定の利用規約にオフラインで同意した場合は、この手順は適用されません。
追加利用規約に同意するには、Partner Sales Console の利用規約のページに移動します。
ステップ 2: Google Cloud プロジェクトを構成する
Google API を使用するには、 Google Cloud プロジェクトが必要です。
Google Cloud プロジェクトを作成する
プロジェクトを作成するには、 Google Cloud コンソールの [プロジェクト] 領域に移動して、 [プロジェクトを作成] をクリックします。
プロジェクトの作成手順とベスト プラクティスの一覧については、プロジェクトの作成と管理ガイドをご覧ください。
ほとんどの販売パートナーは、販売パートナーのドメインではなく、メインのGoogle Cloud 組織の下に Google Cloud プロジェクトを作成します。販売パートナー ドメインからデータにアクセスするには、サービス アカウントが販売パートナー ドメインからデータにアクセスできるように、ドメイン全体の委任を設定します。
プロジェクトにわかりやすい名前を付けます。プロジェクト ID は任意の識別子であり、Cloud Channel API の呼び出しには影響しません。
API を有効にする
コンソールの API ライブラリ セクションに移動し、Cloud Channel API を有効にします。 Google Cloud
サービス アカウントを作成する
サービス アカウントを作成するには、[サービス アカウント] ページに移動します。
- [ サービス アカウントを作成] をクリックします。
- サービス アカウント名（必要に応じてサービス アカウントの説明）を入力し、[作成] をクリックします。
- [続行] をクリックして、[サービス アカウントにプロジェクトへのアクセスを許可する] オプションをスキップします。
- [ユーザーにこのサービス アカウントへのアクセスを許可する] セクションをスキップし、[完了] をクリックしてアカウントの作成を完了します。
アカウントを作成したら、サービス アカウント キーを作成します。
- 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 を確認できます。