导入
按关键词搜索资源
了解搜索资源及其如何根据特定搜索参数检索信息。
...
代码示例
1https://www.googleapis.com/youtube/v3/search
| 参数名 | 类型 | 分类 | 说明 |
|---|---|---|---|
| part | 字符串 | 必需 | 用于指定资源属性的逗号分隔列表 |
| forContentOwner | 布尔值 | 可选 | 用于筛选由用户拥有的视频。使用此参数时,必须设置 onBehalfOfContentOwner 参数。 |
| forDeveloper | 布尔值 | 可选 | 用于限制查询结果,仅返回由开发者应用上传的数据。 |
| forMine | 布尔值 | 可选 | 用于限制查询结果,仅返回由已认证用户上传的数据。 |
| relatedToVideoId | 字符串 | 可选 | 用于限制查询结果,仅返回与指定视频相关的视频。 |
| q | 字符串 | 可选 | 用于在 YouTube 中添加搜索关键词。 |
| maxResults | 整数 | 可选 | 用于指定获取的结果数量。 |
| onBehalfOfContentOwner | 字符串 | 可选 | 用于标识已认证用户正在代表内容所有者进行操作。 |
1// 在此处导入库 2import fetch from 'node-fetch'; 3 4// 在此处定义接口地址 5const endpointUrl = new URL('https://www.googleapis.com/youtube/v3/search'); 6 7// 在此处定义请求头参数 8const headerParameters = { 9 Authorization: 'Bearer {{ACCESS_TOKEN}}', 10 Accept: 'application/json', 11}; 12 13// 在此处定义查询参数 14const queryParameters = new URLSearchParams({ 15 part: 'snippet', 16 maxResults: 25, 17 q: '{{KEYWORD}}', 18}); 19 20// 设置 API 调用选项 21const options = { 22 method: 'GET', 23 headers: headerParameters, 24}; 25 26// 定义发起 API 请求的函数 27async function searchQuery() { 28 try { 29 endpointUrl.search = queryParameters; 30 const response = await fetch(endpointUrl, options); 31 32 // 输出响应结果 33 printResponse(response); 34 } catch (error) { 35 // 输出错误信息 36 printError(error); 37 } 38} 39 40// 调用函数发起 API 请求 41searchQuery();
| 参数名 | 类型 | 说明 |
|---|---|---|
| kind | 字符串 | 反映 API 调用的资源类型。 |
| etag | ETag | 包含资源的 ETag 标识。 |
| id | 字符串 | 包含资源的 ID,与查询参数匹配。 |
| snippet | 对象 | 包含搜索结果的重要信息。 |
| items[] | 列表 | 包含符合搜索条件的响应列表。 |