实现:搜索请求

以下示例演示了如何在 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 不支持视频上传。您可以在 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