GET/users/{userId}/drive/sharedfolders/{sharedFolderId}/files/{fileId}/revisions

共有されたフォルダのファイルバージョンリストを取得する。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

file
file.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/users/{userId}/drive/sharedfolders/{sharedFolderId}/files/{fileId}/revisions

Path Parameters

ParameterTypeDescription
userId string 

ユーザーを特定する ID (URL エンコードする)

  • ユーザー ID (userId)
  • ログイン ID (email)
  • ユーザーの ExternalKey (externalKey:{externalKey})
  • 自身 ("me")

required
example : me 
sharedFolderId string 

共有されたフォルダ ID


required
example : MTIzNDVfRF8xMjM0NQ 
fileId string 

ファイル ID


required
example : NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA 

Query Parameters

ParameterTypeDescription
count integer 

取得数


default : 20
minimum : 1
maximum : 200
example : 20
format : int32 
cursor string 

リストのカーソル値 (URL エンコードする)


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA==
allowReserved : false 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
revisions array (FileRevision) 

バージョン情報

 
responseMetaData object (responseMetaData) 

応答のメタデータ

 

FileRevision

PropertyTypeDescription
createdTime string 

作成日時


readOnly : true 
fileSize integer 

ファイルサイズ


format : int64
readOnly : true 
fileType string 

ファイルタイプ

  • AUDIO : オーディオファイル
  • DOC : 文書ファイル
  • ETC : その他のファイル
  • EXE : 実行ファイル
  • FOLDER : フォルダ
  • IMAGE : 画像ファイル
  • VIDEO : 動画ファイル
  • ZIP : 圧縮ファイル

Allowed values : AUDIO, DOC, ETC, EXE, FOLDER, IMAGE, VIDEO, ZIP 
originalPath string 

初期パス


readOnly : true 
resourceLocation integer 

リソースロケーションコード


format : int32
readOnly : true 
revisionId string 

バージョン ID


readOnly : true 
modifiedTime string 

更新日時


readOnly : true 
updateUser string 

更新ユーザーのユーザー ID (userId)


readOnly : true 

responseMetaData

PropertyTypeDescription
nextCursor string 

次のリスト取得時に使用するカーソル値


readOnly : true 

Response Example

example

1{2  "revisions": [3    {4      "revisionId": "0",5      "resourceLocation": 24101,6      "fileSize": 52255,7      "fileType": "IMAGE",8      "originalPath": "/worksFolder/mobile-18_jpeg.jpeg",9      "createdTime": "2017-06-22T10:50:59.59+09:00",10      "modifiedTime": "2017-05-11T18:31:20.20+09:00",11      "updateUser": "userf7da-f82c-4284-13e7-030f3b4c756x"12    }13  ],14  "responseMetaData": {15    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="16  }17}

HTTP 400

Invalid parameters received.

HTTP 403

Access is denied: no permission.