ファイルの AccessProposals を一覧表示します。注: ファイルに AccessProposals をリストできるのは承認者のみが可能です。ユーザーが承認者でない場合は 403 を返します。
HTTP リクエスト
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
file |
必須。リクエスト対象の商品アイテムの ID。 |
クエリ パラメータ
パラメータ | |
---|---|
page |
省略可。アクセス リクエストのリストの継続トークン。 |
page |
省略可。ページあたりの結果の数 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
アクセス提案リスト リクエストに対するレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"accessProposals": [
{
object ( |
フィールド | |
---|---|
access |
アクセス プロポーザルのリスト。このフィールドは v3 と v3beta でのみ入力されます。 |
next |
次のページの結果の継続トークン。結果リストの最後に達している場合は、この値は存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。 |
認可スコープ
次の 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 ( |
フィールド | |
---|---|
file |
アクセスに関する提案がオンになっているファイル ID |
proposal |
アクセス提案の ID |
requester |
リクエスト元のユーザーのメールアドレス |
recipient |
承認された場合に権限を付与されるユーザーのメールアドレス |
roles |
アクセス プロポーザルのロールとビューのラッパー。 |
request |
リクエスト元が提案に追加したメッセージ |
create |
作成日時 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
RoleAndView
アクセス プロポーザルのロールとビューのラッパー。
JSON 表現 |
---|
{ "role": string, "view": string } |
フィールド | |
---|---|
role |
リクエスト元が提案したロール。新しい値は今後追加される可能性がありますが、現在は次の値を使用できます。* |
view |
このアクセス提案のビューを示します。ビューに属する提案に対してのみ入力されます。サポートされる値は |