如何利用Python脚本结束YouTube Live直播流，配合AJA HELO设备实现推流重置自动化

既然你已经能通过Python获取到精确的stream identifier，那利用YouTube官方的Data API v3来主动结束直播流是最可靠的方案——这能直接告诉YouTube标记当前流为已完成，不会再等待恢复。

步骤1：准备API凭据与依赖 #

• 首先，前往Google Cloud控制台启用YouTube Data API v3，并创建适合的凭据：
  • 如果是服务器端自动化脚本，推荐使用服务账号，并将该账号添加到你的YouTube频道的管理员列表中（确保有操作直播流的权限）。
  • 如果是需要用户交互的场景，可以用OAuth 2.0客户端ID，但自动化场景下服务账号更合适。
• 安装Python依赖库：

  pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib
  

步骤2：Python脚本实现「End Stream」操作 #

下面是结合你已有的stream identifier的代码示例，核心是调用API的streams.transition方法，将直播流状态从active切换为completed：

from google.oauth2 import service_account
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 替换为你的服务账号密钥文件路径
SERVICE_ACCOUNT_FILE = 'path/to/your/service-account-key.json'
# 权限范围必须包含这个，才能操作直播流
SCOPES = ['https://www.googleapis.com/auth/youtube.force-ssl']

def end_youtube_stream(stream_id):
    # 认证初始化
    credentials = service_account.Credentials.from_service_account_file(
        SERVICE_ACCOUNT_FILE, scopes=SCOPES)
    youtube = build('youtube', 'v3', credentials=credentials)

    try:
        # 调用API切换流状态为completed
        request = youtube.streams().transition(
            id=stream_id,
            part='status',
            body={
                'status': {
                    'streamStatus': 'completed'
                }
            }
        )
        response = request.execute()
        print(f"成功结束直播流，流ID: {stream_id}")
        return response
    except HttpError as e:
        print(f"操作出错：{e}")
        return None

# 这里传入你从NMS获取到的stream identifier
if __name__ == "__main__":
    target_stream_id = "your-stream-identifier-here"
    end_youtube_stream(target_stream_id)

关键细节说明 #

• 权限验证：确保服务账号已被添加到YouTube频道的管理员角色，否则会出现权限不足的错误。
• 流状态检查：在调用transition之前，你可以先通过streams.list方法获取当前流的状态，避免重复执行结束操作：

  # 示例：检查流当前状态
  check_request = youtube.streams().list(
      id=stream_id,
      part='status'
  )
  check_response = check_request.execute()
  current_status = check_response['items'][0]['status']['streamStatus']
  if current_status == 'active':
      # 执行结束操作
      end_youtube_stream(stream_id)
  

• 错误处理：API可能返回的错误包括流不存在、权限不足、流已处于非活跃状态等，记得在脚本中捕获并处理这些情况。

替代方案（不推荐） #

如果暂时无法使用API，你也可以尝试用Selenium等浏览器自动化工具模拟手动点击YouTube Studio的「End Stream」按钮，但这种方式稳定性差（比如页面UI更新会导致脚本失效），远不如官方API可靠。

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