YouTube를 Social Quack에 연결하기 — 전체 가이드

YouTube는 TikTok과 비슷합니다. Google 콘솔에서 내 소유의 작은 개발자 앱을 만들고 몇 분 만에 연결하면 바로 업로드할 수 있습니다 — 다만 Google은 프로젝트를 심사하기 전까지 그 업로드를 비공개로 둡니다. 이 페이지에서 두 과정을 모두 안내하며, 입력할 답변도 붙여 넣기만 하면 되도록 준비해 두었습니다. 한 번만 하시면 됩니다.

Google의 심사를 건너뛰고 싶으신가요? 대신 Zernio를 통해 연결하세요. 키 하나를 붙여 넣고 로그인한 뒤 업로드하면 됩니다 — 몇 분이면 되고, 첫날부터 공개 업로드가 됩니다. Zernio 가이드를 참고하세요. 이 페이지는 내 Google Cloud 프로젝트로 직접 하는 방법입니다.

두 단계로 나뉘며, 1단계만 끝내도 업로드를 시작하실 수 있습니다.

Shorts에는 따로 할 것이 없습니다. 3분 미만의 세로 동영상은 자동으로 Short가 됩니다.

1단계 — Google Cloud 프로젝트를 만들고 연결하기

1. https://console.cloud.google.com 으로 가서 내 YouTube 채널을 소유한 Google 계정으로 로그인하세요(아무 Google 계정이어도 됩니다 — 채널은 나중에 고릅니다).

2. 프로젝트 만들기: 위쪽의 프로젝트 선택기 → New project → 이름 입력(예: My Social Quack) → Create를 클릭한 뒤, 그 프로젝트가 선택되어 있는지 확인하세요.

3. API 사용 설정: 왼쪽 메뉴 APIs & Services → Library → YouTube Data API v3 검색 → Enable.

4. 동의 화면 설정: 왼쪽 메뉴 APIs & Services → Google Auth Platform(오래된 프로젝트에서는 OAuth consent screen으로 보입니다) → Get started:

   • App information: 앱 이름(예: My Social Quack), 사용자 지원 이메일 = 내 주소.
   • Audience: External.
   • Contact information: 다시 내 주소 → 동의 → Create.

5. 나를 테스트 사용자로 추가하기: Google Auth Platform → Audience → Test users → Add users → 내 Google 주소 → Save. (앱이 Testing 상태인 동안에는 테스트 사용자만 연결할 수 있습니다.)

6. scope 추가하기: Google Auth Platform → Data Access → Add or remove scopes → youtube로 걸러서 다음에 체크하세요.

   • https://www.googleapis.com/auth/youtube.upload
   • https://www.googleapis.com/auth/youtube.readonly

   → Update → Save. 둘 다 "민감한(sensitive)" scope이지만, 그것은 2단계에서만 상관이 있습니다.

7. 사용자 인증 정보 만들기: Google Auth Platform → Clients → Create client → Application type Desktop app → 이름 입력 → Create. Client ID와 Client secret을 복사하세요(JSON으로 내려받을 수도 있습니다).

   왜 Desktop app일까요? Social Quack은 내 컴퓨터에서 실행되고, Google의 Desktop 클라이언트 유형은 웹사이트를 등록하지 않아도 Social Quack이 사용하는 localhost 주소를 받아들입니다. 이 클라이언트 유형에는 추가할 리디렉션 URI가 없습니다. Google이 redirect_uri_mismatch를 보여 준다면 클라이언트가 Web application으로 만들어진 것이니, Desktop 클라이언트를 새로 만드세요.

8. Social Quack에서: Channels → YouTube → Set up keys ▾ → Set up app keys(채널 → YouTube → 키 설정 → 앱 키 설정) → Client ID와 secret을 붙여 넣고 → Connect(연결). 브라우저에서 Google 로그인이 열립니다. 계정을 고르고, 물으면 채널을 고른 다음, "Google hasn't verified this app" 화면에서 Continue를 클릭하세요(내가 개발자이므로 1단계에서는 예상된 화면입니다). 두 권한에 모두 체크 → Continue. 채널이 Connected 아래에 나타납니다.

9. Compose(작성)에서 테스트 동영상을 올려 보세요. 동영상을 첨부하고 YouTube 채널에 체크한 다음, 나타나는 YouTube options(YouTube 옵션) 패널을 채우세요 — 제목, 공개 범위, made for kids(아동용) 선언, 태그. 지금 게시하거나 예약하세요. YouTube Studio를 열면 동영상이 있습니다 — 어떤 공개 범위를 골랐든 Private으로요. 심사받지 않은 프로젝트에 대한 Google의 규칙이지(2단계 참고) Social Quack의 버그가 아닙니다.

1단계에 있는 동안 알아 두실 두 가지:

• 7일마다 다시 연결하세요. Google은 Testing 상태인 앱의 연결을 7일 뒤에 만료시킵니다. 그렇게 되면 Social Quack이 Channels에서 알려 드리니 Connect를 다시 클릭하세요. 2단계를 마치면 이 일이 없어집니다.
• 할당량: 새 프로젝트는 하루 100개의 동영상을 업로드할 수 있고, 그 밖의 호출에 10,000 단위를 쓸 수 있습니다(썸네일 하나에 50). 개인이나 소규모 팀에게는 충분합니다. 에이전시는 2단계에서 더 요청할 수 있습니다.

2단계 — 심사 받기(공개 업로드, 영구적인 연결)

서로 다른 Google 팀이 맡는 두 가지 심사가 따로 있습니다. 둘 다 하세요. 각각 양식 하나입니다.

A. YouTube API 준수 감사 — "비공개 전용" 규칙 해제

2020년 7월 28일 이후 만들어진 모든 프로젝트는, YouTube가 YouTube API Services 서비스 약관 준수 여부를 감사하기 전까지 업로드가 Private으로 고정됩니다.

1. YouTube API Services – Audit and Quota Extension Form을 여세요: https://support.google.com/youtube/contact/yt_api_form
2. 아래 '그대로 붙여 넣는 답변'으로 채우세요. API 클라이언트를 묻는 곳에는 내 채널에만 쓰는 개인용 데스크톱 예약 도구라고 적고, 데모를 묻는 곳에는 아래 '데모 동영상'에서 설명하는 화면 녹화를 첨부하세요.
3. 하루 100개보다 많이 업로드하고 싶으시다면, 같은 양식에서 할당량 증가를 요청하고 몇 개가 필요한지 적으세요.

감사를 통과하면 이메일이 옵니다. 그때부터는 Social Quack에서 고른 공개 범위(Public / Unlisted / Private)가 YouTube에 그대로 적용됩니다.

B. OAuth 앱 인증 — 7일마다 다시 연결하는 일과 경고 화면 없애기

1. Google Auth Platform → Audience → Publish app → 확인. 이제 앱이 In production 상태입니다. 이때부터 연결이 7일 뒤에 만료되지 않습니다. 인증이 끝나기 전까지는 로그인할 때 여전히 "Google hasn't verified this app"가 표시됩니다 — Advanced → Go to (앱 이름)을 클릭해 계속하세요. Google은 인증되지 않은 앱 하나당 최대 100명까지 그렇게 하도록 허용하니, 채널 하나에는 차고 넘칩니다.
2. Google Auth Platform → Branding: 앱 로고를 추가하고(선택), Authorized domains에 socialquack.com을 추가하세요. Application home page는 https://socialquack.com, Privacy policy는 https://socialquack.com/privacy, Terms of service는 https://socialquack.com/terms. 저장하세요.
3. Google Auth Platform → Verification Center → Prepare for verification → 내용 확인 → scope마다 아래 '그대로 붙여 넣는 답변'의 사유를 붙여 넣고 → 데모 동영상 링크를 추가하세요(YouTube에 Unlisted로 올리거나 Drive에 올리세요) → Submit for verification.
4. Google이 질문과 결과를 이메일로 보냅니다. 소규모 개인 앱의 인증은 동영상에 동의 화면과 각 권한이 쓰이는 모습이 나오기만 하면 대개 승인됩니다.

B는 완전히 건너뛰고 경고 화면과 Advanced → Go to app 클릭을 감수하셔도 됩니다 — 개인의 선택입니다. 공개 업로드를 원하신다면 A는 건너뛸 수 없습니다.

그대로 붙여 넣는 답변

Google의 양식은 영어이므로, 아래 답변은 영어 그대로 붙여 넣으세요.

What does your application do?

Personal social-media scheduling tool. I write and schedule posts on my own computer (Social Quack, a self-hosted scheduler that runs locally on my Mac/PC) and it uploads them to my own YouTube channel at the scheduled time. Single user: me. The application never accesses other users' data, does not read comments or analytics, and stores nothing on any server — access tokens are kept encrypted on my computer only and deleted when I disconnect the channel.

How is each scope used?

youtube.upload — uploads the video file for a post I created and scheduled myself, with the title, description, tags and visibility I chose, and sets the thumbnail I attached.

youtube.readonly — reads my own channel's name and avatar once, to show which channel is connected in the app.

API client / platform → Desktop application installed on the user's own computer; website https://socialquack.com.

Expected number of users → 1 (my own account). Quota → the default is enough (or state the number of uploads per day you need).

Do you display or store YouTube data? → No. The app only uploads; it shows the channel name in its own settings page and stores nothing about other users.

데모 동영상 — 무엇을 녹화하나

60–90초짜리 화면 녹화를 한 번에 찍으세요. 음성 설명은 필요 없습니다. Mac: ⌘⇧5 또는 QuickTime → New Screen Recording.

1. (0:00) Social Quack을 열고 Channels 페이지를 보여 주세요.
2. (0:05) YouTube에서 Connect를 클릭하세요. 브라우저에서 Google 로그인이 열립니다 — 두 권한이 모두 나오는 동의 화면을 보여 주고 Continue를 클릭하세요. 채널이 이제 Connected 아래에 있는 Social Quack 화면을 보여 주세요.
3. (0:25) Compose: 짧은 동영상을 첨부하고 YouTube 채널에 체크한 뒤, YouTube options 패널(제목, 공개 범위, made-for-kids)을 채우고 Post now(지금 게시)를 클릭하세요.
4. (0:45) Queue(예약 목록)에서 게시물이 published로 바뀌는 것을 보여 주고 그 링크를 클릭하세요.
5. (1:00) 내 채널의 YouTube Studio에서 동영상을 보여 주세요.
6. (1:15, 선택) Channels → YouTube 채널을 Remove(삭제)해서, 연결을 끊으면 접근 권한이 철회된다는 것을 보여 주세요.

문제가 생겼을 때