🛠️ YouTube 자동화 파이프라인: HTTP API & OAuth 2.0 직접 제어 가이드

# 🛠️ YouTube 자동화 파이프라인: HTTP API & OAuth 2.0 직접 제어 가이드

**문서 작성일:** 2026-03-13
**작성자:** 조용한 부의 설계자 & AI 어시스턴트
**목적:** Make.com 기본 YouTube 모듈의 잦은 토큰 만료(400 Error) 및 권한 오류(403 Error)를 우회하여, 묵묵하고 안정적으로 돌아가는 백엔드 업로드 시스템 구축.

—

## 📋 [To-Do List] 자동화 시스템 구축 마스터 플랜
– [ ] 독립된 GCP 프로젝트 선정 및 YouTube Data API v3 활성화
– [ ] GCP OAuth 동의 화면 세팅 (Testing -> In Production 전환)
– [ ] Custom OAuth 클라이언트 ID/Secret 발급 및 리디렉션 URI 일치화
– [ ] Make.com HTTP 모듈 (Make an OAuth 2.0 request) 세팅
– [ ] Access Token 헤더 주입 및 Multipart 페이로드 설계
– [ ] 파이프라인 스케줄링 및 모니터링 적용

—

## 🔍 실행 가능성 검증 (Executability Check)
– **시스템 요구사항 확인:** 본 가이드는 다수의 브랜드 채널을 운영하며 일일 업로드 제한(Quota)을 초과하지 않는 범위 내에서 단일 GCP 프로젝트를 활용하는 구조를 전제로 작성되었습니다.
– 모든 설정은 Google Cloud Console의 관리자 권한이 있는 상태에서 유효합니다.

—

## 1. 인프라 기반 다지기 (GCP 프로젝트 세팅)
블랙박스 같은 기본 모듈을 걷어내고 통제권을 쥐기 위한 첫걸음입니다. 남의 서버가 아닌 ‘내 서버(GCP)’의 자격을 증명해야 합니다.

– **프로젝트 격리:** 기존 프로젝트와 섞지 않고, 자동화 전용 GCP 프로젝트를 신규로 생성하거나 용도가 분리된 깨끗한 프로젝트를 사용합니다.
– **API 활성화:** API 및 서비스 > 라이브러리에서 YouTube Data API v3를 반드시 ‘사용 설정(Enable)’ 합니다.

—

## 2. 문지기 통과하기 (OAuth 2.0 설정 및 에러 해결)
가장 많은 개발자가 좌절하는 인증 단계입니다. 구글의 깐깐한 보안 정책(400, 403 에러)을 우아하게 회피하는 설정값입니다.

– **403 access_denied 에러 (프라이빗 클럽의 저주):** GCP OAuth 동의 화면에서 게시 상태가 ‘테스트 중(Testing)’일 때 발생합니다.
– **해결책:** 앱 게시(Publish App) 버튼을 눌러 **’프로덕션(In production)’**으로 과감히 전환합니다. (내부 사용 목적이므로 구글 앱 검토는 무시합니다).
– **400 redirect_uri_mismatch 에러 (길 잃은 토큰):** Make.com이 요구하는 콜백 주소가 GCP에 등록되지 않아 발생합니다.
– **해결책:** GCP 사용자 인증 정보 > OAuth 2.0 클라이언트 ID 수정 화면에서 승인된 리디렉션 URI에 `https://www.integromat.com/oauth/cb/oauth2` 를 토씨 하나 틀리지 않고 추가합니다.

—

## 3. 시스템의 혈관 연결 (API 직접 호출)
토큰이라는 비밀 통행증을 얻었다면, 서버의 헤더(Header)에 이를 실어 보내야 합니다.

### Make.com HTTP 모듈 세팅 (Make an OAuth 2.0 request)
– **Authorize URI:** `https://accounts.google.com/o/oauth2/v2/auth`
– **Token URI:** `https://oauth2.googleapis.com/token`
– **Scope:** `https://www.googleapis.com/auth/youtube.upload`
– **API Endpoint:** `https://www.googleapis.com/upload/youtube/v3/videos?uploadType=multipart&part=snippet,status` (메소드: POST)

### 대안: Google Apps Script (GAS) 코드 구현
만약 Make.com을 벗어나 순수 코드로 제어할 때 사용하는 템플릿입니다.

“`javascript
function uploadVideoDirectly() {
var accessToken = “발급받은_Access_Token”;
var url = “https://www.googleapis.com/youtube/v3/videos?part=snippet,status”;
var headers = {
“Authorization”: “Bearer ” + accessToken, // Bearer 뒤 띄어쓰기 1칸 필수
“Accept”: “application/json”,
“Content-Type”: “application/json”
};
var videoMetadata = {
“snippet”: {
“title”: “시스템이 빚어낸 수익”,
“description”: “백엔드 코드로 완성된 자동화 파이프라인”,
“categoryId”: “22”
},
“status”: {
“privacyStatus”: “private”
}
};
var options = {
“method”: “post”,
“headers”: headers,
“payload”: JSON.stringify(videoMetadata),
“muteHttpExceptions”: true
};
var response = UrlFetchApp.fetch(url, options);
Logger.log(response.getResponseCode());
}
“`

—

## 4. 자원 관리와 확장성 (Quota & Multi-channel)
하나의 GCP Client ID로 여러 브랜드 계정을 연결하는 것은 아키텍처상 완벽히 가능하며 권장됩니다. Make.com에서 Connection만 분리하여 연결하면 됩니다. 단, 구글의 자비 없는 API 할당량(Quota)을 수학적으로 계산해야 합니다.

– **프로젝트당 일일 기본 할당량:** 10,000 Units
– **동영상 업로드 1회 소모량:** 1,600 Units
– **하루 최대 업로드 가능 수량:** `⌊10,000 / 1,600⌋ = 6 videos/day`

**전략:** 총합 하루 6개를 초과하는 업로드가 필요하다면, 단일 ID 아키텍처를 버리고 브랜드 채널별로 GCP 프로젝트를 물리적으로 분리하여 할당량을 확장해야 합니다.