Reseller API のスコープの選択

このドキュメントには、Reseller API 固有の認可と認証の情報が記載されています。このドキュメントを読む前に、認証と認可について学習するで、Google Workspace の一般的な認証と認可の情報を必ずお読みください。

認可用に OAuth 2.0 を構成する

OAuth 同意画面を構成し、スコープを選択して、ユーザーとアプリの審査担当者に表示する情報を定義し、後で公開できるようにアプリを登録します。

Reseller API のスコープ

アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは OAuth 2.0 URI 文字列で、Google Workspace アプリ名、アクセスするデータの種類、アクセスレベルが含まれます。スコープとは、ユーザーの Google アカウント データを含む Google Workspace データを操作する、アプリからのリクエストです。

アプリがインストールされると、ユーザーはアプリで使用されているスコープを検証するよう求められます。一般的には、可能な限り最も狭い範囲のスコープを選択し、アプリが必要としないスコープをリクエストしないようにする必要があります。ユーザーが、明確に説明された制限付きのスコープに対するアクセス権を付与しやすくなります。

一般公開アプリケーションが特定のユーザーデータへのアクセスを許可するスコープを使用している場合は、確認プロセスを完了する必要があります。アプリケーションのテスト中に、画面に未確認のアプリが表示された場合は、確認リクエストを送信してそのアプリを削除する必要があります。ヘルプセンターで未確認アプリの詳細を確認し、 アプリの確認に関するよくある質問への回答をご確認ください。

Reseller API では次のスコープがサポートされています。

範囲	意味
https://www.googleapis.com/auth/apps.order	Reseller API のすべてのオペレーションにアクセスするためのグローバル スコープ。
https://www.googleapis.com/auth/admin.directory.user	すべてのユーザーとユーザー エイリアスのオペレーションにアクセスするためのグローバル スコープ。
https://www.googleapis.com/auth/siteverification	既存の確認済みサイトに対する完全読み取りアクセス権と新しいサイトの確認機能のグローバル スコープ。