如何使用YouTube Java API根据话题标签获取随机YouTube视频

YouTube Data API本身没有提供直接返回随机视频的原生接口，无需依赖第三方中转服务，通过「随机化搜索参数 + 结果集二次随机抽取」的方案即可实现需求，随机性可满足绝大多数场景使用。

前置准备 #

• 开通YouTube Data API v3服务，获取自身的API密钥
• 引入官方Java客户端依赖，Maven配置参考如下：

<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-youtube</artifactId>
    <version>v3-rev20221108-2.0.0</version>
</dependency>
<dependency>
    <groupId>com.google.oauth-client</groupId>
    <artifactId>google-oauth-client-java6</artifactId>
    <version>1.34.1</version>
</dependency>

具体实现步骤 #

1. 构造基础搜索参数 #

查询关键词指定为目标话题标签（例如#meme），限定返回结果为视频，单次请求拉取最大允许的50条结果：

• q：填写目标话题标签，格式为#标签名
• type：固定为video，仅返回视频内容
• maxResults：设置为50，是单次搜索请求的返回上限
• part：固定为id,snippet，获取视频基础信息

2. 两层随机保证结果随机性 #

1. 请求参数随机：每次请求随机选择排序规则，可选值为relevance（相关性）、date（发布时间）、rating（评分）、viewCount（播放量），每次随机取一种扩大结果池范围
2. 翻页随机：首次请求拿到搜索结果总条数，计算总页数（YouTube搜索最多返回1000条结果，总页数最多为20），生成随机页码后获取对应分页的pageToken，拉取该页的50条结果后，再随机抽取其中1条作为最终结果

3. Java实现代码示例 #

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.youtube.YouTube;
import com.google.api.services.youtube.model.SearchListResponse;
import com.google.api.services.youtube.model.SearchResult;
import java.util.List;
import java.util.Random;

public class RandomYoutubeVideoByTag {
    // 替换为自身的API密钥
    private static final String API_KEY = "YOUR_API_KEY";
    private static final Random RANDOM = new Random();
    // 可选的排序规则池
    private static final String[] ORDER_TYPES = {"relevance", "date", "rating", "viewCount"};

    public static SearchResult getRandomVideoByTag(String tag) throws Exception {
        // 初始化YouTube客户端
        YouTube youtube = new YouTube.Builder(
                GoogleNetHttpTransport.newTrustedTransport(),
                GsonFactory.getDefaultInstance(),
                null
        ).setApplicationName("random-youtube-video").build();

        // 构造基础搜索请求
        YouTube.Search.List searchRequest = youtube.search().list("id,snippet");
        searchRequest.setKey(API_KEY);
        searchRequest.setQ("#" + tag);
        searchRequest.setType("video");
        searchRequest.setMaxResults(50L);
        // 随机选择排序方式
        searchRequest.setOrder(ORDER_TYPES[RANDOM.nextInt(ORDER_TYPES.length)]);

        SearchListResponse response = searchRequest.execute();
        long totalResults = Math.min(response.getPageInfo().getTotalResults(), 1000);
        int totalPages = (int) Math.ceil(totalResults / 50.0);
        // 随机选择目标页码
        int randomPage = RANDOM.nextInt(totalPages);

        // 跳转至随机分页
        String pageToken = response.getNextPageToken();
        for (int i = 1; i < randomPage && pageToken != null; i++) {
            searchRequest.setPageToken(pageToken);
            response = searchRequest.execute();
            pageToken = response.getNextPageToken();
        }

        // 从当前页结果中随机抽取1条
        List<SearchResult> items = response.getItems();
        return items.get(RANDOM.nextInt(items.size()));
    }

    public static void main(String[] args) throws Exception {
        // 示例：获取带#meme标签的随机视频
        SearchResult randomVideo = getRandomVideoByTag("meme");
        System.out.println("视频标题：" + randomVideo.getSnippet().getTitle());
        System.out.println("视频ID：" + randomVideo.getId().getVideoId());
    }
}

注意事项 #

• 配额消耗：每次搜索请求消耗100单位API配额，官方默认每日配额为10000，可满足日常调用需求
• 匹配精准度：如果需要更高的标签匹配精度，可以在查询参数中补充subject:#标签名进一步过滤结果
• 随机性优化：如果需要更高的随机性，可以在查询词后追加随机生成的1位字符，进一步扩大结果覆盖范围

内容的提问来源于stack exchange，提问作者CarryLove