Method: accessproposals.list

ファイルに対するアクセス提案を一覧表示します。詳細については、保留中のアクセス提案を管理するをご覧ください。

注: ファイルのアクセス提案を一覧表示できるのは承認者のみです。ユーザーが承認者でない場合は、403 エラーが返されます。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
fileId

string

必須。リクエストの対象となるアイテムの ID。

クエリ パラメータ

パラメータ
pageToken

string

省略可。アクセス権リクエストのリストの継続トークン。

pageSize

integer

省略可。ページあたりの結果の数。

リクエストの本文

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

レスポンスの本文

アクセス提案リスト リクエストに対するレスポンス。

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

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

object (AccessProposal)

アクセス提案のリスト。このフィールドは、Drive API v3 でのみ入力されます。

nextPageToken

string

結果の次のページの継続トークン。結果リストの最後に達している場合、この値は存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。

認可スコープ

次の 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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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