实现:搜索请求

以下示例演示了如何在 v3 API 中完成多种不同类型的搜索请求。

视频

此示例调用 search.list 方法,以查找与查询“滑板狗”相关联的观看次数最多的高清 (HD) 视频。该查询会设置 orderpartqtypevideoDefinition 参数。

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