导入
请求参数和响应字段
探索 Dailymotion 数据对象的请求参数和响应字段。
请求参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| fields | String | 该参数定义了响应中要返回的字段列表。 |
| availability | Boolean | 该参数将结果限制为仅包含可用的视频。 |
| channel | String | GET – 该参数将视频限制为请求中指定的频道。POST – 该参数定义视频所属的频道。需要根据视频的类型/类别提供相应的频道 ID。 |
| country | String | 该参数接收国家的声明代码,并将响应限制在指定国家范围内。 |
| sort | String | 该参数定义视频的排序方式。 |
| tags | String | GET – 该参数根据指定标签过滤视频。POST – 该参数定义与视频相关的标签列表。 |
| published | Boolean | 该参数用于发布草稿视频。 |
| title | String | 该参数定义视频的标题。 |
| is_created_for_kids | Boolean | 该参数非常重要,因为 Dailymotion 团队需要根据其值来精准定位目标受众。 |
| video_Id | Integer | 这是视频的唯一标识符。 |
| allow_embed | Boolean | 该参数定义该视频是否可以在 Dailymotion 之外嵌入使用。 |
| language | String | 该参数定义视频的语言。这是一个由用户提供的 ISO-639-3 alpha-2 和 alpha-3 语言代码组成的声明性值。 |
| private | Boolean | 该参数定义该视频是否为私密视频。 |
| description | String | 该参数定义视频的描述内容。最大长度为 3000 个字符。 |
| nogenre | String | 这是一个过滤参数,用于排除指定类型的视频。 |
| id | Integer | 该参数是用户的唯一标识符。 |
| ids | String | 这是一个过滤参数,用于将结果限制在给定的 ID 列表中。该参数适用于以 'x' 开头的 ID。 |
| page | Integer | 这是一个分页参数,用于定义加载结果中的第几页。 |
| limit | Integer | 这是一个分页参数,用于定义结果中每页的项目数量。 |
响应字段
| 响应字段 | 描述 |
|---|---|
| page | 该字段显示返回的页面编号。API 调用默认返回第一页。该参数的最大值为 100。 |
| limit | 该字段显示单页最多可包含的项目数量。可通过请求中的 limit 参数进行调整。最大限制为 100。 |
| total | 该字段显示结果中项目的近似总数。 |
| has_more | 布尔字段,用于结果的分页处理。表示当前页面之后是否还有更多结果页。 |
| owner | 该字段显示拥有该视频的用户 ID。 |
| id | 该字段显示视频的唯一标识符。 |
| channel | 该字段显示视频所属的频道名称。 |
| title | 该字段显示视频的标题。 |
| upload_url | 上传视频到 Dailymotion 服务器所需的 URL。 |
| progress_url | 用于获取视频上传状态的 URL。对这个 URL 发起 GET 请求会返回一个包含 state 键的 JSON 响应,该键的值表示上传进度。 |
| acodec | 该字段定义视频的编码格式。 |
| dimension | 该字段表示已上传视频的尺寸信息。 |
| duration | 该字段定义视频的时长(单位:秒)。 |
| name | 该字段显示视频文件的名称。 |
| size | 该字段定义视频文件的大小(单位:字节)。 |
字段与过滤条件
| 名称 | 类型 | 描述 |
|---|---|---|
| fields | String | 该参数定义响应中要返回的字段列表。 |
| sort | String | 该参数定义播放列表的排序方式。 |
| page | Integer | 这是一个分页参数,用于定义加载结果中的第几页。 |
| limit | Integer | 这是一个分页参数,用于定义结果中每页的项目数量。 |
| owner | Integer | 该参数将结果限制为指定用户的播放列表。 |
| search | String | 根据此搜索查询限制结果集。 |
| created_time | Date | 播放列表的创建日期和时间。 |
| description | String | 播放列表的描述信息。 |
| id | Integer | 播放列表的唯一 ID。 |
| name | String | 播放列表的名称。 |
| private | Boolean | 播放列表为私密时为 true,否则为 false。 |
| updated_time | Date | 播放列表最后一次更新的日期和时间。 |
| videos_total | Integer | 播放列表中视频的总数。 |
| tags | String | 该过滤参数用于根据指定标签从播放列表中检索视频。默认对多个标签执行 AND 操作;若需使用 OR 操作,可在查询项上使用括号 ()。 |
字段与过滤条件
| 名称 | 类型 | 描述 |
|---|---|---|
| fields | String | 该参数定义响应中要返回的字段列表。 |
| country | String | 该参数显示用户的居住国家。将结果限制在指定国家范围内。接受 ISO 3166-1 alpha-2 国家代码。 |
| language | String | 该参数将结果限制为语言与指定语言一致的用户。 |
| sort | String | 该参数用于更改结果的默认排序顺序。 |
| page | Integer | 该参数定义要加载的页面编号。 |
| limit | Integer | 该参数定义单页最多返回的项目数量。 |
| id | 标识符 | 用户的唯一 ID。 |
| screenname | String | 显示在屏幕上的用户名。 |
| username | String | 用户的用户名。 |
| videos_total | Number | 用户公开视频的总数。 |
| views_total | Number | 用户所有视频的总观看次数。 |
| status | String | 该字段包含用户账户的信息。用于判断账户状态是否为活跃、禁用、待激活或未知。 |
字段与过滤条件
| 名称 | 类型 | 描述 |
|---|---|---|
| fields | String | 该参数定义响应中希望获取的字段。 |
| sort | String | 该参数定义结果集中项目的排列顺序。 |
| description | String | 该字段显示频道的描述信息。 |
| id | Integer | 该字段显示频道的唯一标识符。 |
| name | String | 该字段显示频道的名称。 |