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

共有されたフォルダのファイルのリンク共有を取得する。

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}/link

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 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
accessType string 

リンク共有範囲

  • ORGANIZATION: 社内メンバー
  • SPECIFIC_PEOPLE: 許可した人のみ (OTP 認証)
  • ANYONE: 誰でもアクセス可能

Allowed values : ORGANIZATION, SPECIFIC_PEOPLE, ANYONE 
hasPassword boolean 

リンクのアクセスパスワードの有無

 
linkPermissionType string 

リンク権限タイプ
リンクを通してアクセスする場合、与えられた権限範囲での操作のみ行えます。

  • EDIT: 編集 (移動、削除、復元 等)、アップロード/コピー (上書き可能)、ダンロード、閲覧
  • UPLOAD_DOWNLOAD: アップロード/コピー (上書き不可)、ダンロード、閲覧
  • UPLOAD: アップロード/コピー (上書き不可)、閲覧
  • DOWNLOAD: ダンロード、閲覧
  • PREVIEW: 閲覧

Allowed values : EDIT, UPLOAD_DOWNLOAD, UPLOAD, DOWNLOAD, PREVIEW 
linkUrl string 

リンク URL


readOnly : true 
createdTime string 

リンク作成時刻


readOnly : true 
expirationTime string 

リンク有効期限 (有効期限がない場合には null)


nullable : true 
specificPeople array (string) 

許可した人のみアクセス可能 (OTP 認証) なリンクのアクセス可能ユーザーリスト


nullable : true 

Response Example

example

1{2  "accessType": "SPECIFIC_PEOPLE",3  "hasPassword": false,4  "linkUrl": "https://works.do/xzO8Bv",5  "createdTime": "2024-10-10T09:18:24+09:00",6  "expirationTime": "2024-10-17T09:18:24+09:00",7  "linkPermissionType": "EDIT",8  "specificPeople": [9    "abc@example.com"10  ]11}