导入
列出类别并获取类别详情
学习如何使用 Vimeo API 列出分类并提取这些分类的详细信息。
...
| 参数名称 | 类型 | 可选性 | 描述 |
|---|---|---|---|
| direction | 字符串 | 可选 | 该参数定义响应的排序顺序。可选值为 asc（升序）和 desc（降序）。 |
| page | 整数 | 可选 | 用于指定在响应中显示的页码。 |
| per_page | 整数 | 可选 | 该参数定义每页显示的记录数量。每页最多显示 100 条记录。 |
1import requests 2import json 3 4url = "https://api.vimeo.com/categories" 5# url = "https://api.vimeo.com/categories?direction=asc&page=2&per_page=5" 6 7headers = { 8 'Content-type': 'application/json', 9 'Authorization': 'Bearer {{AUTH_CODE}}' 10} 11 12response = requests.request("GET", url, headers=headers) 13if response.status_code != 200: 14 print("以下错误已产生") 15 16print(json.dumps(response.json(), indent=4))
| 响应字段 | 描述 |
|---|---|
| total | 项目/分类的总数。其值为 10，因为 Vimeo 共有 10 个分类。 |
| page | 表示响应中返回的页数。 |
| per_page | 表示每页显示的记录/分类数量。 |
| data | 包含所有与分类相关字段的数组。 |
| uri | 用于访问该分类的唯一标识符。不包含基础 URL。 |
| name | 表示分类的名称。 |
| link | 分类的完整 URL。可复制粘贴到浏览器地址栏中访问该分类。 |
| last_video_featured_time | 以 ISO 8601 格式显示最近一次视频被推荐的时间。 |
| metadata | 包含与分类相关的元数据的对象。 |
| subcategories | 列出主分类下所有可用子分类的数组。 |
1url = "https://api.vimeo.com/categories/adsandcommercials" 2 3headers = { 4 'Content-type': 'application/json', 5 'Authorization': 'Bearer {{AUTH_CODE}}' 6} 7 8response = requests.request("GET", url, headers=headers) 9if response.status_code != 200: 10 print("以下错误已产生") 11 12print(json.dumps(response.json(), indent=4))
| 字段名称 | 描述 |
|---|---|
| metadata.connections | 该对象包含与该分类相关联的信息。 |
| metadata.connections.channels | 该对象提供有关该分类中频道的信息。包括 uri（获取该分类频道的 URL）、options（可在此 URL 上执行的 HTTP 方法数组）、total（频道总数）。 |
| metadata.connections.groups | 该对象包含与该分类所属群组相关的信息。同样包含 uri、options 和 total 字段。 |
| metadata.connections.users | 该对象包含与该分类相关的用户信息。 |
| metadata.connections.videos | 该对象定义了与该分类相关的视频的 uri、允许的方法以及视频总数。 |
| metadata.interactions | 该对象显示与该分类相关的允许操作。 |
| metadata.interactions.follow | 该对象显示当前认证用户是否关注了该分类。 |
| metadata.interactions.follow.added | 布尔类型字段，表示用户是否已关注该分类。若已关注，值为 true；否则为 false。 |
| metadata.interactions.follow.added_time | 字符串字段，表示认证用户执行关注操作的时间，格式为 ISO 8601。 |
| metadata.interactions.follow.uri | 用户关注或取消关注分类的链接。用户可通过向此 URI 发送 PUT 请求来关注，发送 DELETE 请求来取消关注。 |