实现：搜索请求

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

视频

此示例调用 search.list 方法，以查找与查询“skateboarding dog”关联的观看次数最多、高清 (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 Cloud 控制台中开发者的应用关联的项目编号。

当搜索请求随后将 forDeveloper 参数设置为 true 时，API 服务会使用请求的授权凭据来识别开发者。因此，开发者可以将结果限制为通过开发者自己的应用或网站上传的视频，但不包括通过其他应用或网站上传的视频。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true