5분 만에 끝내는 YouTube Data API 키 발급 및 설정법

Q: 403 오류가 떠요.

대부분 '할당량 초과'이거나 '키 제한 설정' 때문입니다. 리퍼러 설정이나 API 활성화 여부를 확인해보세요.

유튜브 API 키 발급, 5분이면 끝! 복잡해 보이는 구글 클라우드 콘솔에서 헤매지 않고, 유튜브 데이터를 가져오기 위한 API 키를 가장 쉽고 안전하게 발급받는 방법을 알려드립니다.

혹시 웹사이트에 유튜브 영상을 자동으로 불러오거나, 특정 채널의 구독자 수를 실시간으로 확인하고 싶으신가요? 저도 처음 개발 공부를 시작했을 때 이 기능이 너무 구현하고 싶어서 무작정 뛰어들었던 기억이 나네요. 하지만 막상 Google Cloud Console에 들어가면 온통 영어에 복잡한 메뉴들 때문에 덜컥 겁부터 나더라고요. 😅

하지만 걱정 마세요! 알고 보면 과정은 정말 단순하답니다. 오늘 제가 옆에서 알려주는 것처럼 하나하나 차근차근 설명해 드릴게요. 이 글만 따라오시면 여러분도 금방 ‘개발자’스러운 API 키를 손에 넣으실 수 있을 거예요! 준비되셨나요? 출발해봐요! 😊

Table of Contents

1단계: 구글 클라우드 프로젝트 만들기 🏗️

API 키를 받으려면 먼저 우리의 작업 공간인 ‘프로젝트’를 만들어야 해요. 구글은 모든 API 사용 내역을 이 프로젝트 단위로 관리하거든요.

Google Cloud Console 접속: 먼저 Google Cloud Console에 접속해서 구글 계정으로 로그인해주세요.
새 프로젝트 생성: 상단 로고 옆에 있는 프로젝트 선택 콤보 박스(▼)를 클릭하고, 우측 상단의 [새 프로젝트] 버튼을 눌러주세요.
이름 짓기: 프로젝트 이름은 ‘YouTube-Data-Project’처럼 본인이 알아보기 쉬운 이름으로 지어주세요. (나중에 수정이 어려울 수 있으니 신중하게!)
만들기 클릭: 잠시 기다리면 프로젝트 생성이 완료되었다는 알림이 뜰 거예요.

💡 알아두세요!
프로젝트를 생성한 후에는 반드시 상단 메뉴에서 방금 만든 프로젝트를 선택했는지 확인해야 해요. 엉뚱한 프로젝트에서 작업하면 나중에 헷갈릴 수 있거든요!

2단계: YouTube Data API v3 활성화하기 📺

프로젝트라는 ‘집’을 지었으니, 이제 그 안에 ‘유튜브 TV’를 들여놓을 차례예요. 구글 클라우드에는 수많은 API가 있기 때문에 우리가 사용할 서비스를 콕 집어서 켜줘야 합니다.

상단 검색창에 YouTube Data API v3라고 검색해보세요. 검색 결과에서 해당 항목을 클릭하고, 파란색 [사용] 버튼을 꾹 눌러주세요. 로딩이 조금 걸릴 수 있는데, 잠시 차 한 잔의 여유를 가지셔도 좋아요. ☕

3단계: 대망의 API 키 발급받기 🔑

드디어 하이라이트입니다! API를 활성화하면 대시보드 화면이 나올 텐데요, 여기서 왼쪽 메뉴를 잘 봐주세요.

유튜브api

좌측 메뉴에서 [사용자 인증 정보(Credentials)]를 클릭합니다.
상단의 [+ 사용자 인증 정보 만들기]를 누르고 [API 키]를 선택하세요.
짜잔! 🎉 화면에 알 수 없는 영어와 숫자가 섞인 긴 코드가 떴죠? 그게 바로 여러분의 API 키입니다!

⚠️ 주의하세요!
생성된 API 키는 절대 남에게 보여주거나 GitHub 같은 공개된 곳에 올리면 안 돼요! 누군가 여러분의 키를 도용해서 사용하면, 하루 사용량(Quota)이 금방 바닥나거나, 최악의 경우 요금 폭탄(유료 API의 경우)을 맞을 수도 있답니다.

4단계: 키 제한 설정하기 (보안 필수! 🛡️)

키를 발급받자마자 “됐다!” 하고 창을 닫으시는 분들이 많은데요, 제발 그러지 마세요! 😭 키 제한 설정은 선택이 아니라 필수입니다. 도둑이 들어오지 못하게 문단속을 하는 과정이라고 생각해주세요.

생성된 키 목록의 우측에 있는 [키 수정](연필 아이콘)을 누르면 제한 설정을 할 수 있습니다.

제한 유형	추천 대상	설정 방법
HTTP 리퍼러	웹사이트 운영자	내 도메인(예: `mysite.com/*`)만 허용
IP 주소	서버 개발자	내 서버의 고정 IP 주소 입력
API 제한	모든 사용자 (필수)	YouTube Data API v3만 선택

특히 API 제한 부분에서 ‘키 제한’을 선택하고 YouTube Data API v3를 체크해주는 것은 꼭 해주세요. 이렇게 하면 혹시 키가 털리더라도 유튜브 관련 기능 외에는 사용할 수 없게 막을 수 있거든요.

📝

핵심 요약 노트

1. 프로젝트 생성: 구글 클라우드 콘솔에서 새 프로젝트를 만드세요.

2. API 활성화: 라이브러리에서 YouTube Data API v3를 찾아 사용 설정을 누릅니다.

3. 키 발급: 사용자 인증 정보에서 API Key를 생성합니다.

4. 보안 설정: HTTP 리퍼러나 IP 제한을 걸어 키 도용을 방지하세요.

하루 10,000 할당량을 기억하고 효율적으로 사용하세요!

자주 묻는 질문 ❓

Q: API 사용은 무료인가요?

A: 네, 기본적으로 무료입니다. 하지만 하루 할당량(10,000 단위)을 초과하면 더 이상 데이터를 불러오지 못합니다. 할당량을 늘리려면 구글에 별도로 신청해야 합니다.

Q: API 키를 잃어버렸어요!

A: 당황하지 마세요. 사용자 인증 정보 페이지에서 언제든지 키를 다시 확인하거나, 보안이 걱정된다면 기존 키를 삭제하고 새로 생성하면 됩니다.