上传 DriveItem 的自定义缩略图
借助此请求,应用可以将自定义缩略图(即使文件内容更新,缩略图也会继续留在文件中)上传到任何具有 file Facet 的项中。 如果已设置上传的自定义缩略图,此请求将覆盖上传的现有自定义缩略图。
注意: 仅 OneDrive 个人版支持自定义缩略图。
HTTP 请求
PUT /drive/items/{item-id}/thumbnails/0/source/content
Content-Type: application/octet-stream
<<The contents of the image goes here.>>
响应
HTTP/1.1 200 OK
如果成功,此调用将返回 200 OK 响应,以指明自定义缩略图已成功上传。 在此响应中,Content-Location 和 Location 响应头将返回自定义缩略图 URL。
确定是否已有上传的自定义缩略图
若要确定文件中是否已有上传的自定义缩略图,请在缩略图集中查找 source 属性。 如果此属性有值,则值表示上传的自定义缩略图。 如果没有,则表明尚无上传的自定义缩略图。
注意: 仅 OneDrive 个人版支持自定义缩略图。
GET /drive/items/{item-id}/?expand=thumbnails(select=id,large,medium,small,source)
响应
HTTP/1.1 200 OK
Content-Type: application/json
{
"thumbnails":[
{
"id":"0",
"large":{
"height":800,
"url":"https://dhbkba-sn3302.files.1drv.com/y2mfq7dB...IlE9xeFMPb0jZMt7SI",
"width":753
},
"medium":{
"height":176,
"url":"https://dhbkba-sn3302.files.1drv.com/y2m...Gx3-VnOqMmoW4l15cjX9ADw",
"width":166
},
"small":{
"height":96,
"url":"https://dhbkba-sn3302.files.1drv.com/y2m2T1...SLCIKpScctlzybSdNXxE",
"width":90
},
"source":{
"height":500,
"url":"https://dhbkba-sn3302.files.1drv.com/y2m2T1...89mxla9x7OeLhMdbIteg",
"width":500
}
}
]
}
注意: 为清楚起见,将截断 Response 对象。 实际调用会返回所有默认属性。