以下示例演示了如何在 v3 API 中完成几种不同类型的搜索请求。
视频
此示例调用 search.list
方法,查找与查询“滑板狗”相关的观看次数最多的高清 (HD) 视频。该查询会设置 order
、part
、q
、type
和 videoDefinition
参数。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
如需查看代码示例,请参阅 search.list
方法的文档。
播放列表
以下示例展示了如何查找与查询字词“GoogleDevelopers”匹配的播放列表。它会调用 search.list
方法,并将 type
参数的值设置为 playlist
,使结果集仅包含播放列表。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
频道
以下示例展示了如何查找与查询字词“travel”相匹配的频道。它会调用 search.list
方法,并将 type
参数的值设置为 channel
,使结果集仅包含频道。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
与特定语言相关的结果
此示例会调用 search.list
方法来查找与特定语言最相关的搜索结果。该示例显示查询字词为 marine (q=marine
),并且 API 响应应包含与法语 (relevanceLanguage=fr
) 最相关的结果。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
请注意,该请求不为 type
参数设置值,这意味着每个搜索结果都会引用视频、播放列表或频道。
通过开发者的应用或网站上传的视频
此示例展示了如何使用 forDeveloper
参数将搜索限制为仅检索通过开发者的应用或网站上传的视频。此参数可与可选的搜索参数(例如 q
参数)结合使用。
注意:此查询不会在 API Explorer 中返回结果,因为 API Explorer 不支持视频上传。您可以在 API Explorer 之外为自己的应用运行此查询,但无法使用 API Explorer 获取您的应用的搜索结果。
每个上传的视频都会自动使用与 Google API 控制台中开发者的应用相关联的项目编号进行标记。
当搜索请求随后将 forDeveloper
参数设置为 true 时,API 服务会使用请求的授权凭据来标识开发者。因此,开发者可以将结果限制为通过开发者自己的应用或网站上传的视频,但不能仅限于通过其他应用或网站上传的视频。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true