以下示例演示了如何在 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 不支持上传视频。您可以在 APIs Explorer 之外针对自己的应用运行此查询,但无法使用 APIs Explorer 获取您的应用的结果。
系统会自动为每个上传的视频添加项目编号,该编号与开发者的应用在 Google API 控制台中关联。
当搜索请求随后将 forDeveloper
参数设置为 true 时,API 服务会使用请求的授权凭据来识别开发者。因此,开发者可以将结果限制为仅显示通过开发者自己的应用或网站上传的视频,而不会显示通过其他应用或网站上传的视频。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true