YouTube API 키 받기

Astral Overlay의 YouTube 채팅에는 본인의 YouTube Data API v3 키가 필요합니다. Twitch 패널에는 이 설정이 필요하지 않습니다.

1. Google Cloud 열기

Google Cloud Console을 열고 Google 계정으로 로그인하세요. 상단 프로젝트 선택기에서 프로젝트를 만들거나 이 연동에 쓰는 기존 프로젝트를 고르세요.

Astral Overlay Chat 같은 이름이면 나중에 알아보기 쉽습니다. 다음 단계에서도 그 프로젝트를 선택한 상태로 두세요.

API 라이브러리에서 YouTube Data API v3 페이지를 열고 사용을 선택하세요.

이미 켜져 있으면 사용자 인증 정보로 이동하세요. 다른 YouTube 관련 API를 켜도 이 단계를 대신하지 못합니다.

API 및 서비스 > 사용자 인증 정보에서 사용자 인증 정보 만들기 > API 키를 선택하세요.

키가 접근할 API를 물으면 YouTube Data API v3를 고르세요. 생성된 키를 복사하고 알아보기 쉬운 이름을 붙이세요.

OAuth 클라이언트 ID나 서비스 계정 인증 정보가 아닌 API 키를 선택하세요. 현재 채팅 설정은 키 문자열을 받습니다.

콘솔 배치가 다르면 Google의 YouTube 인증 정보 안내를 참고하세요.

사용자 인증 정보에서 키 설정을 여세요.

Astral Overlay는 컴퓨터에서 직접 요청합니다. 이 문서 사이트를 포함한 웹사이트 제한은 맞지 않습니다. Android와 iOS 제한도 적합하지 않습니다.

접근을 더 제한하려면 IP 주소 제한으로 컴퓨터의 공인 인터넷 IP를 허용할 수 있습니다. 연결이나 VPN이 바뀌면 갱신해야 합니다. 127.0.0.1이나 가정용 네트워크의 사설 주소를 입력하지 마세요.

앱 제한을 없음으로 두면 키가 특정 컴퓨터에 묶이지 않습니다. API 제한을 YouTube 전용으로 유지하고 키를 비공개로 보관하세요. Google의 제한 참고 문서에 선택지가 설명되어 있습니다.

채널 홈페이지 대신 실시간 영상 URL을 쓰세요. 키는 화면에서 가려지며 새 키는 채팅 추가 시 저장됩니다. 카드에서 저장된 키를 지울 수도 있습니다.

메시지 또는 증상	확인 사항
API가 꺼져 있음	키가 속한 프로젝트에서 YouTube Data API v3를 켜세요.
잘못된 키	API 키를 다시 복사하세요. 클라이언트 ID나 프로젝트 ID를 붙여 넣지 마세요.
키 제한이 앱을 차단함	YouTube API 제한과 웹사이트 또는 외부 IP 제한이 이 컴퓨터를 거부하는지 확인하세요.
할당량 소진	프로젝트의 API 할당량을 확인하세요. 같은 프로젝트에서 키를 다시 만들어도 할당량은 새로 생기지 않습니다.
실시간 채팅 없음	영상이 라이브이고 채팅을 사용할 수 있는지 확인하세요.

YouTube API 요청은 프로젝트 할당량을 소비합니다. Google의 할당량 문서에 요청 비용과 일일 초기화가 설명되어 있습니다. 실제 할당량은 콘솔에서 확인하세요.

스크린샷, 소스 코드나 지원 요청에 키를 올리지 마세요. 노출되면 Google Cloud에서 교체하고 Astral Overlay에도 새 키를 입력하세요.