유튜브 API 키 발급받고 등록하기
떡상 검색은 검색하는 그 순간 유튜브를 직접 호출합니다. 기본은 떴어영의 공용 할당량을 나눠 쓰기 때문에 하루 검색 횟수에 제한이 있는데, 개인 API 키를 등록하시면 회원님의 할당량을 우선 사용해 제한이 풀립니다. 검색당 크레딧도 5 CR에서 2 CR로 줄어듭니다.
- 1
구글 클라우드 프로젝트 만들기
console.cloud.google.com에 구글 계정으로 로그인한 뒤, 상단 프로젝트 선택기에서 '새 프로젝트'를 눌러 하나 만듭니다. 이미 쓰시던 프로젝트가 있다면 그대로 쓰셔도 됩니다.
💡 프로젝트 이름은 나중에 알아보기만 하면 되니 편하게 정하셔도 됩니다.
- 2
YouTube Data API v3 켜기
왼쪽 메뉴에서 'API 및 서비스 > 라이브러리'로 가서 'YouTube Data API v3'를 검색해 들어간 뒤 '사용 설정'을 누릅니다.
⚠️ 이 단계를 건너뛰면 키를 발급받아도 호출할 때 오류가 납니다. 키가 잘못된 게 아니라 API가 꺼져 있는 것이니, 오류가 나면 여기부터 확인해 보세요.
- 3
API 키 발급받기
'API 및 서비스 > 사용자 인증 정보'로 이동해 상단의 '+ 사용자 인증 정보 만들기'를 누르고 'API 키'를 고릅니다. 만들어진 키 문자열을 복사해 둡니다.
- 4
키에 제한 걸어두기
발급된 키를 눌러 'API 제한사항'에서 'YouTube Data API v3'만 허용하도록 지정합니다. 이렇게 해두면 키가 새어 나가도 다른 구글 서비스에 쓰이지 못합니다.
💡 필수는 아니지만 1분이면 끝나고, 사고가 났을 때 피해 범위를 크게 줄여줍니다.
- 5
떴어영에 등록하기
로그인 후 설정의 API 키 관리 화면에서 복사한 키를 붙여넣고 저장합니다. 저장한 키는 서버에만 보관되고 화면에는 앞뒤 네 자리만 보이도록 가려서 표시됩니다.
💡 처음 등록하시면 일회성 보너스 30 CR을 드립니다.
- 6
잘 붙었는지 확인하기
떡상 검색을 한 번 돌려보세요. 키가 정상이면 하루 검색 횟수 제한 없이 검색되고, 검색당 차감도 줄어든 값으로 표시됩니다. 키를 지우면 즉시 공용 할당량 모드로 돌아갑니다.
자주 묻는 질문
YouTube Data API v3는 프로젝트마다 하루 10,000 유닛의 무료 할당량을 줍니다. 떡상 검색 한 번에 100유닛 안팎이 들기 때문에 개인 용도로는 무료 한도 안에서 충분합니다. 결제 정보를 등록하지 않으면 한도를 넘겨도 자동 과금되지 않고 호출이 막힐 뿐입니다.
아닙니다. 검색당 5 CR에서 2 CR로 줄어듭니다. 유튜브 호출 비용은 회원님 할당량에서 나가지만, 떡상배수·반응도 계산과 결과 처리는 떴어영 서버에서 계속 이뤄지기 때문입니다.
무료 플랜은 하루 5회, 유료 플랜은 하루 7회입니다. 개인 키를 등록하시면 이 제한이 적용되지 않습니다.
키는 서버에만 저장되고, 화면에는 앞 네 자리와 뒤 네 자리만 남긴 마스킹 형태로 표시됩니다. 언제든 API 키 관리 화면에서 삭제하실 수 있습니다.
