YouTube · 설정 가이드
YouTube 데이터 API 키를 생성하는 방법
StreamBruh는 공개 비디오 검색 및 채널 업로드 확인을 위해 YouTube Data API v3 키를 사용합니다. Google 클라우드 할당량 및 API 키 제한은 이러한 예약된 검사에 영향을 미칠 수 있습니다.
단계별 설정
Google 클라우드 프로젝트 생성 또는 선택
Google 계정으로 Google Cloud Console에 로그인하세요. 이러한 알림을 위한 프로젝트를 생성하거나 관리하는 프로젝트를 선택하세요. 콘솔 헤더에서 원하는 프로젝트가 활성화되어 있는지 확인하세요.
YouTube Data API v3 활성화
APIs & Services → Library에서 YouTube Data API v3를 검색하고 해당 프로젝트에 대해 활성화합니다. 키만 생성하면 API가 활성화되지 않습니다.
API 키 생성
APIs & Services → Credentials를 열고 Create credential → API key를 선택한 후 생성된 키를 복사합니다. API 액세스를 YouTube Data API v3로 제한합니다. 공개 페이지와 소스 제어에 키를 보관하지 마세요.
StreamBruh는 방문자의 브라우저가 아닌 서버에서 Google를 호출합니다. 웹사이트 또는 HTTP 리퍼러 제한으로 인해 해당 서버 요청이 차단됩니다. StreamBruh 지원이 VPS에 대한 안정적인 공개 송신 IP를 확인하는 경우 추가로 해당 IP에 대한 키를 제한할 수 있습니다. 그렇지 않으면 YouTube API 제한을 유지하고 사용량을 모니터링합니다.
StreamBruh에 키를 저장합니다.
봇 및 통합을 열고 키를 YouTube API 키에 붙여넣은 후 저장합니다. 저장된 키는 마스크되어 있습니다. 기존 키를 유지하려면 나중에 편집할 때 필드를 비워 두세요.
검색 또는 채널 선택
YouTube 검색 알림은 검색어와 일치하는 새로운 공개 동영상을 따릅니다. 언어 설정은 보장보다는 관련성 기본 설정이며 쉼표로 구분된 차단 단어는 해당 용어가 포함된 제목을 제외합니다. 채널 알림은 양식에서 지원하는 YouTube @handle 링크, 채널 ID 링크, 핸들 또는 채널 ID를 허용합니다.
Discord 대상 채널을 선택하고 메시지를 사용자 정의한 후 저장합니다. 점검은 일정에 따라 실행됩니다. 검색 요청 및 채널 확인은 YouTube API 할당량을 다양한 비율로 사용합니다. 결과는 YouTube 가용성에 따라 달라집니다.
설정을 확인하세요
- YouTube Data API v3는 키와 동일한 프로젝트에서 활성화됩니다.
- 키의 API 제한 사항에는 YouTube Data API v3가 포함되며 해당 클라이언트 제한 사항은 VPS를 허용합니다.
- 채널 링크가 확인되거나 검색 구성이 저장되고 봇은 선택한 Discord 채널로 보낼 수 있습니다.
문제 해결
API 키가 거부됨
키가 선택한 프로젝트에 속하고 YouTube Data API v3가 활성화되어 있으며 해당 제한 사항이 VPS의 요청을 허용하는지 확인하세요. 브라우저 리퍼러 제한은 서버측 호출과 일치하지 않습니다.
할당량이 소진되었습니다.
YouTube 데이터 API 사용량 및 할당량은 Google Cloud Console에서 검토하세요. 불필요한 검색을 줄이거나 적격한 경우 Google를 통해 할당량 연장을 요청하세요. 할당량이 사용 가능해지면 다시 시도하세요.
게시된 동영상이 없습니다.
마지막 확인 이후 새 공개 동영상이 검색 또는 채널과 일치하는지, 차단된 단어가 제목을 제외하는지, Discord 채널이 전송 가능한 상태로 유지되는지 확인하세요. 예약된 점검은 즉시 이루어지지 않습니다.