上传 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-LocationLocation 响应头将返回自定义缩略图 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 对象。 实际调用会返回所有默认属性。