名称 |
类型 |
必填 |
描述 |
路径 |
字符串 |
是 |
文件夹的路径。 |
file_limit |
整数 |
否 |
缺省值为 10,000(最大值为 25,000)。在列出一个文件夹时,服务不会报告超过指定文件量的列表,而是返回 406(不可接受)状态响应。 |
hash |
字符串 |
否 |
文件夹上的每个 /metadata 调用都将返回一个散列字段,通过散列化此响应中包含的所有元数据而生成。在稍后的 /metadata 调用上,您应该通过此参数提供此值,因此如果未更改任何项,那么响应将是 304(未修改)状态代码,而不是可能非常大的完整文件夹列表。如果指定的路径与文件相关联或者如果 list=false,那么将忽略此参数。 |
List |
布尔值 |
否 |
字符串 true 和 false 为有效值。缺省值为 true。如果为 true,那么文件夹的元数据将包含内容字段及文件夹内容的元数据条目列表。如果为 false,那么将省略内容字段。 |
include_deleted |
布尔 |
否 |
仅在设置列表时适用。如果此参数设置为 true,那么内容将包含已删除的子代的元数据。请注意,无论此标志是什么,始终返回元数据调用的目标,即使已删除(is_deleted 设置为 true)。 |
rev |
字符串 |
否 |
如果包含特定修订版号,那么将仅返回此修订版的元数据。 |
locale |
字符串 |
否 |
返回的元数据将根据指定的语言环境转换其大小字段。 |
include_media_info |
布尔值 |
否 |
如果为 true,那么每个文件将包含照片的 photo_info 字典和包含其他媒体信息的视频的 video_info 字典。如果数据尚不可用,那么将返回字符串暂挂,而不是字典。 |
include_membership |
布尔值 |
no |
如果为 true,那么共享文件夹的元数据将包含一个成员列表和一个组列表。 |