PATCH/groups/{groupId}/folder/files/{fileId}/permissions/{permissionId}

組織/グループのフォルダアクセス権限を部分更新する。

Authorization

oauth2

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

Scope

file
group.folder

HTTP Request

PATCHhttps://www.worksapis.com/v1.0/groups/{groupId}/folder/files/{fileId}/permissions/{permissionId}

Path Parameters

ParameterTypeDescription
groupId string 

組織/グループの ID (URL エンコードする)

  • 組織フォルダの場合、組織 ID (orgUnitId)
  • グループフォルダの場合、グループ ID (groupId)

required
example : group127-8545-4463-603b-04d550d23bf 
fileId string 

ファイル ID


required
example : NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA 
permissionId string 

アクセス権限 ID


required
example : QDIxMDAwMDAwMDAwMTcwfEdST1VQfDEwMTAwMDAwMDExNDY1MA 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
type string 

編集権限

  • READ : 読み込み権限
  • WRITE : 書き込み権限

required
Allowed values : READ, WRITE 

Request Example

example

1{2  "type": "WRITE"3}

Response

HTTP 200

OK

PropertyTypeDescription
permissionId string 

アクセス権限 ID


required
minLength : 1
readOnly : true 
type string 

編集権限

  • READ : 読み込み権限
  • WRITE : 書き込み権限

required
Allowed values : READ, WRITE 
userId string 

ユーザー ID (userId)
組織 ID (orgUnitId)
グループ ID (groupId)


required
minLength : 1
readOnly : true 
userType string 

ユーザータイプ

  • USER : ユーザー
  • ORGUNIT : 組織
  • GROUP : グループ

required
Allowed values : USER, ORGUNIT, GROUP 
userName string 

ユーザー名
組織名
グループ名


required
minLength : 1
readOnly : true 

Response Example

example

1{2  "permissionId": "QDIxMDAwMDAwMDAwMTcwfEdST1VQfDEwMTAwMDAwMDExNDY1MA",3  "type": "WRITE",4  "userId": "group127-8545-4463-603b-04d550d23bf",5  "userType": "GROUP",6  "userName": "グループ1"7}