Method: files.accessproposals.list

ファイルの AccessProposals を一覧表示します。注: ファイルに AccessProposals をリストできるのは承認者のみが可能です。ユーザーが承認者でない場合は 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)

アクセス プロポーザルのリスト。このフィールドは 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

ファイルの未処理のアクセス提案に対する Access Proposal リソース

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 のみです。