Method: permissions.list

ファイルまたは共有ドライブの権限を一覧表示します。詳しくは、ファイル、フォルダ、ドライブを共有するをご覧ください。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
fileId

string

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

クエリ パラメータ

パラメータ
pageSize

integer

返す権限の最大数。サービスから返される数は、この値より少ない場合があります。

指定されていない場合は、共有ドライブに対して最大 100 件の権限が返され、共有ドライブ以外のドライブに対しては権限のリスト全体が返されます。

最大値は 100 です。100 を超える値は 100 に強制変換されます。
pageToken

string

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

boolean

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

boolean

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

boolean

ドメイン管理者としてリクエストを発行します。

true に設定され、次の追加条件が満たされている場合、リクエスト元にアクセス権が付与されます。

  1. ファイル ID パラメータが共有ドライブを参照している。
  2. リクエスト元が、共有ドライブが属するドメインの管理者である。

詳しくは、ドメイン管理者として共有ドライブを管理するをご覧ください。
includePermissionsForView

string

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

リクエストの本文

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

レスポンスの本文

ファイルに対する権限のリスト。

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

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

object (Permission)

権限のリスト。nextPageToken が入力されている場合、このリストは不完全である可能性があり、結果の追加ページを取得する必要があります。
nextPageToken

string

権限の次のページのページトークン。権限リストの末尾に達した場合、このフィールドは存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。通常、ページトークンは数時間有効です。ただし、新しいアイテムが追加または削除された場合は、予測される結果が異なる可能性があります。
kind

string

リソースの種類を示します。値は固定文字列 "drive#permissionList" です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • 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

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