ファイルに対するアクセス提案を一覧表示します。詳細については、保留中のアクセス提案を管理するをご覧ください。
注: ファイルのアクセス提案を一覧表示できるのは承認者のみです。ユーザーが承認者でない場合は、403 エラーが返されます。
HTTP リクエスト
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
fileId |
必須。リクエストの対象となるアイテムの ID。 |
クエリ パラメータ
パラメータ | |
---|---|
pageToken |
省略可。アクセス権リクエストのリストの継続トークン。 |
pageSize |
省略可。ページあたりの結果の数。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
アクセス提案リスト リクエストに対するレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"accessProposals": [
{
object ( |
フィールド | |
---|---|
accessProposals[] |
アクセス提案のリスト。このフィールドは、Drive API v3 でのみ入力されます。 |
nextPageToken |
結果の次のページの継続トークン。結果リストの最後に達している場合、この値は存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。 |
認可スコープ
次の 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
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。