Method: permissions.list

ファイルまたは共有ドライブの権限を一覧表示します。

HTTP リクエスト

GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
fileId

string

ファイルまたは共有ドライブの ID。

クエリ パラメータ

パラメータ
maxResults

integer

ページごとに返される権限の最大数。共有ドライブ内のファイルに対して設定しない場合、最大 100 件の結果が返されます。共有ドライブ内にないファイルに対して設定しない場合、リスト全体が返されます。

pageToken

string

次のページで前の list リクエストを続行するためのトークン。これは、前のレスポンスの nextPageToken の値に設定する必要があります。

supportsAllDrives

boolean

リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。

supportsTeamDrives
(deprecated)

boolean

非推奨: 代わりに supportsAllDrives を使用してください。

useDomainAdminAccess

boolean

ドメイン管理者としてリクエストを発行します。true に設定した場合、ファイル ID パラメータが共有ドライブを参照しており、リクエストしたユーザーがその共有ドライブが属するドメインの管理者であれば、リクエスト元にアクセス権が付与されます。

includePermissionsForView

string

レスポンスに含める追加のビューの権限を指定します。published のみがサポートされています。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ファイルに関連付けられている権限のリスト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
フィールド
nextPageToken

string

権限の次のページ用のページトークン。権限リストの最後に達している場合、このフィールドは存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、ページ分けを結果の最初のページから再開する必要があります。

kind

string

これは常に drive#permissionList です。

etag

string

リストの ETag。

items[]

object (Permission)

権限のリスト。

認可スコープ

次の 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

一部のスコープは制限されており、アプリで使用するにはセキュリティ評価が必要です。詳細については、承認ガイドをご覧ください。