ファイルまたは共有ドライブの権限を一覧表示します。
HTTP リクエスト
GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
fileId |
ファイルまたは共有ドライブの ID。 |
クエリ パラメータ
パラメータ | |
---|---|
maxResults |
ページごとに返される権限の最大数。共有ドライブ内のファイルに設定されていない場合、最大 100 件の結果が返されます。共有ドライブにないファイルに設定されていない場合、リスト全体が返されます。 |
pageToken |
前のリスト リクエストを次のページで続行するためのトークン。これは、前のレスポンスの |
supportsAllDrives |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。 |
supportsTeamDrives |
非推奨: 代わりに、 |
useDomainAdminAccess |
ドメイン管理者としてリクエストを送信します。true に設定すると、ファイル ID パラメータが共有ドライブを参照し、リクエスト元が共有ドライブが属するドメインの管理者である場合、リクエスト元にアクセス権が付与されます。 |
includePermissionsForView |
レスポンスに含める追加ビューの権限を指定します。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
ファイルに関連付けられている権限のリスト。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"items": [
{
object ( |
フィールド | |
---|---|
nextPageToken |
次のページの権限のページトークン。権限リストの最後まで到達した場合、このフィールドは存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。 |
kind |
これは常に |
etag |
リストの ETag。 |
selfLink |
このリストへのリンク。 |
items[] |
権限のリスト。 |
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
一部のスコープは制限されており、アプリで使用するにはセキュリティ評価が必要です。詳しくは、認可ガイドをご覧ください。