如何实现WordPress上传视频至YouTube并回嵌展示到网站

前置准备（必须先完成） #

• 注册Google Cloud账号，开通YouTube Data API v3权限，创建OAuth2.0授权凭据，授权范围勾选youtube.upload、youtube.readonly，记录生成的客户端ID、客户端密钥，授权回调地址填自己WordPress站点的后台对应回调路径，必须是HTTPS地址，HTTP地址会直接鉴权失败。
• 绑定的YouTube频道要提前完成手机号验证，新号未验证的话API上传权限默认是关闭的，会直接报权限错误。

方案1：零代码插件实现（适合无开发能力的运营者） #

• 进入WordPress后台插件安装页，筛选安装支持YouTube API直传的正规媒体上传插件，激活后进入插件设置页，填入之前拿到的OAuth2.0凭据，点击授权按钮，跳转到Google账号授权页，选择要绑定的目标YouTube频道，完成账号绑定。
• 打开插件设置里的上传完成自动拉取视频信息开关，设置上传后视频的默认可见状态（公开/未列出/私享），勾选「自动生成嵌入代码」选项，可自定义嵌入播放器的尺寸、是否展示相关推荐、是否显示控制栏等参数。
• 配置自动嵌入规则：设置上传完成后，嵌入代码自动插入到对应文章/页面的指定位置，不需要手动粘贴。
• 日常使用流程：编辑内容时，直接在编辑器的插件专属上传入口选择本地视频，点击「上传到YouTube」，插件会在后台自动完成上传流程，等YouTube转码完成后，插件会自动拉取对应视频的唯一ID，生成标准嵌入代码插入到当前编辑的内容里，发布页面后就能直接看到嵌入的视频播放器。
• 实用配置：记得打开插件的上传失败自动重试功能，大视频上传容易受网络波动影响中断，设置3次自动重试能减少重复操作。

方案2：自定义代码实现（适合有开发能力的用户） #

不想用第三方插件的话，可以自己开发对应功能，核心逻辑如下：

1. 在主题的functions.php文件或者自定义功能插件中，编写YouTube API鉴权逻辑，将OAuth2.0凭据存储在WordPress的options配置表中，不要硬编码在代码里避免凭据泄露。
2. 给WordPress原生媒体上传器添加「上传到YouTube」的自定义选项，挂载媒体上传钩子，用户触发上传到YouTube的操作时，将本地临时文件分片上传到YouTube Data API的上传接口，单分片大小建议设为10MB，提升大视频上传稳定性。
3. 编写定时轮询逻辑，每隔30秒请求一次YouTube的视频状态接口，检测到视频状态为processed（即YouTube平台转码完成）时，自动拉取对应视频的videoId字段。
4. 按照WordPress oEmbed规范生成标准嵌入代码，参考格式如下：

<iframe width="100%" height="500" src="https://www.youtube.com/embed/[替换为拉取到的videoId]" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

5. 将生成的嵌入代码自动插入到当前编辑文章的post_content字段对应位置，同时把videoId存储到文章的自定义字段中，后续要调整播放器参数直接修改自定义字段即可，不需要反复编辑正文。

• 体验优化：前端添加上传进度条展示，避免用户误以为页面卡顿重复提交上传；添加上传、转码完成的站内通知，不用手动刷新查状态。

常见问题排查 #

• 上传提示权限不足：检查Google Cloud后台的YouTube Data API v3是否真的启用，OAuth授权范围是否勾选正确，当前授权的Google账号是否是目标YouTube频道的主管理员，子账号默认没有API上传权限。
• 上传完成后拉取不到嵌入代码：YouTube收到视频文件后需要转码处理，10分钟以内的短视频一般1-2分钟转码完成，长视频耗时更长，不要刚传完就拉取信息，必须等转码完成才能拿到有效视频ID。
• 前台页面嵌入视频不显示：检查站点是否配置了内容安全策略（CSP），需要将YouTube相关域名加到iframe加载白名单里，不然浏览器会拦截嵌入内容。

内容的提问来源于stack exchange，提问作者HASEEB ALAM RAFIQ