Method: files.accessproposals.list

파일에 Access제안을 나열합니다. 참고: 승인 담당자만 파일에 AccessRFP를 표시할 수 있습니다. 사용자가 승인자가 아닌 경우 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)

액세스 제안 목록입니다. 이 필드는 v3 및 v3beta에서만 채워집니다.
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

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

AccessProposal

파일에 남아 있는 액세스 제안에 대한 액세스 제안 리소스

JSON 표현 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
필드
fileId

string

액세스 제안이 있는 파일 ID입니다.
proposalId

string

액세스 제안서 ID
requesterEmailAddress

string

요청한 사용자의 이메일 주소
recipientEmailAddress

string

수락 시 권한을 받게 되는 사용자의 이메일 주소입니다.
rolesAndViews[]

object (RoleAndView)

액세스 제안서의 역할 및 뷰를 위한 래퍼입니다.
requestMessage

string

요청자가 제안서에 추가한 메시지
createTime

string (Timestamp format)

생성 시간

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

RoleAndView

액세스 제안서의 역할 및 뷰를 위한 래퍼입니다.

JSON 표현 
{
  "role": string,
  "view": string
}
필드
role

string

요청자가 제안한 역할입니다. 향후 새로운 값이 추가될 수 있지만 현재는 다음 값을 사용할 수 있습니다. * writer * commenter * reader
view

string

이 액세스 제안에 대한 보기를 나타냅니다. 뷰에 속한 제안서에 대해서만 채워집니다. 유일하게 지원되는 값은 published입니다.