Method: accessproposals.list

파일의 액세스 제안을 나열합니다. 자세한 내용은 대기 중인 액세스 제안 관리를 참고하세요.

참고: 승인자만 파일의 액세스 제안을 나열할 수 있습니다. 사용자가 승인자가 아니면 403 오류가 반환됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
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

일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.