도움말

toolulah Upload

1. 시작하기

  1. 가입: 회원가입 화면에서 아이디와 비밀번호를 정하면 바로 가입됩니다(복구 이메일은 선택).
  2. Google로 로그인: 로그인·회원가입 화면의 “Google 계정으로 계속”을 누르면 아이디·비밀번호 없이 바로 시작할 수 있습니다. 처음이면 동의 화면을 거쳐 계정이 만들어집니다(아이디는 자동, 한 번 바꿀 수 있음). 이메일이 같아도 기존 아이디 계정에 자동으로 연결되지 않습니다 — 기존 계정에 붙이려면 로그인한 뒤 “내 계정”에서 “Google 계정 연결”을 누르세요. Google로만 가입한 계정은 “내 계정”에서 비밀번호를 설정하면 아이디 로그인도 쓸 수 있습니다.
  3. 동의: 가입할 때 개인정보처리방침과 이용약관(YouTube 이용약관 포함)에 동의하고 만 14세 이상임을 확인합니다. 문서가 바뀌면 다음 로그인 때 다시 동의를 받습니다.
  4. 복구 코드: 가입 직후 1회용 복구 코드 10개를 한 번만 보여 드립니다. 안전한 곳에 적어 두세요. 비밀번호를 잊으면 비밀번호 찾기에서 아이디와 복구 코드 하나로 새 비밀번호를 정할 수 있습니다(쓴 코드는 사라짐). “내 계정”에서 비밀번호를 다시 입력하면 새 코드를 발급할 수 있습니다.
  5. 채널 연결: “채널” 화면에서 “채널 연결”을 누르고 구글 동의 화면에서 영상을 올릴 채널(브랜드 계정 포함)을 고르세요. 서로 다른 구글 계정의 채널도 여러 개 연결할 수 있고, 채널마다 별칭을 붙여 구분할 수 있습니다. 한 유튜브 채널은 한 서비스 계정에만 연결됩니다.

2. 영상 예약하기

  1. “예약” 화면에서 새 예약을 누릅니다.
  2. 영상 파일을 고르면 바로 올리기 시작합니다(mp4·mov·webm, 최대 20GiB). 큰 파일은 여러 조각으로 나눠 보내며, 연결이 끊기면 자동으로 이어서 보냅니다. 창을 닫았다면 같은 파일을 다시 고르면 받은 곳부터 이어집니다.
  3. 썸네일(선택, JPG·PNG): 맞춤 썸네일은 유튜브에서 인증된 채널만 쓸 수 있습니다. 쇼츠는 앱에서 썸네일이 쓰이지 않을 수 있습니다.
  4. 채널과 정보: 채널, 제목(100자 이하), 설명, 태그, 카테고리, 언어를 입력합니다. 아동용 여부와 변경·합성 콘텐츠 여부는 반드시 골라야 합니다. 입력한 내용은 고치지 않고 그대로 유튜브에 보냅니다. 길이를 넘으면 자르지 않고 다시 입력하도록 알려 드립니다.
  5. 공개 범위와 예약 시각: 공개 범위를 고르고 예약 시각을 입력합니다. 예약 시각은 내 컴퓨터 시간대로 입력하며, 서버는 UTC로 저장합니다(최대 14일 뒤까지).
  6. 확인 화면: 요약을 확인하고 “커뮤니티 가이드를 준수합니다” 상자에 표시한 뒤 예약 버튼을 누르면 예약됩니다. 이 확인이 없으면 예약되지 않습니다.

서비스 전체가 유튜브 할당량을 나눠 쓰므로, 할당량이 차면 다음 시도 시각으로 미뤄집니다.

3. 예약 상태 보기

대기
예약 시각을 기다리고 있습니다. 이 상태에서는 취소할 수 있습니다.
미뤄짐
할당량이나 채널 한도 때문에 미뤄졌습니다. 다음 시도 시각이 표시되며, 취소할 수 있습니다.
업로드 중
지금 유튜브로 보내고 있습니다.
완료
올라갔습니다. 유튜브 링크로 확인하세요.
실패
올리지 못했습니다. 사유가 함께 표시됩니다.
확인 필요
올라갔는지 확실하지 않아 중복을 막으려고 다시 보내지 않습니다. 유튜브 스튜디오에서 채널을 확인하고, 필요하면 운영자에게 알려 주세요.
만료
업로드 기한 안에 올리지 못해 끝났습니다. 파일은 지워졌습니다.
취소됨
사용자가 취소했거나 채널 연결이 해제됐습니다.

4. 업로드 도구 연결(개인 API 토큰)

“API 토큰” 화면에서 토큰을 발급하면, 내가 쓰는 업로드 도구가 내 계정으로 예약을 제출할 수 있습니다. 토큰으로는 발급한 사람의 연결 채널에만 올릴 수 있고, 도구는 내가 직접 승인한 영상만 제출해야 합니다. 토큰은 발급할 때 한 번만 보이며 언제든 회수할 수 있습니다.

요청 형식과 예제는 개발자 API 문서에 있습니다.

5. 성과 분석

“성과 분석” 화면(/app/analytics)에서 연결한 채널을 고르면 다음을 볼 수 있습니다. 데이터는 YouTube API Services에서 읽어 오며 나에게만 보입니다.

  • 채널 개요: 구독자 수·총 조회수·영상 수(권한 youtube.readonly).
  • 기간별 성과(최근 7·28·90일): 일별 조회수·시청 시간 그래프, 인기 영상, 유입 경로, 시청자 연령·성별 비율, 국가, 기기(권한 yt-analytics.readonly). 분석 데이터는 하루 정도 늦게 들어오므로 어제까지를 보여 줍니다.
  • 최근 영상: 최근에 올린 영상의 조회수·좋아요·댓글 수와 공개 범위.
  • 대량 보고서: “대량 보고서 켜기”를 누르면 YouTube가 일별 보고서를 만들기 시작하고, 서비스는 최신 보고서를 받아 요약만 남깁니다(원본 파일은 저장하지 않음).

결과는 최대 24시간 동안만 캐시해 다시 쓰고, 30일을 넘겨 보관하지 않습니다. 채널 연결을 해제하거나 계정을 삭제하면 즉시 지웁니다. 채널 카드에 “권한 추가 필요”가 보이면 그 채널을 다시 연결하면서 구글 동의 화면에서 통계·분석 읽기 권한을 허용하세요.

내 도구에서 같은 데이터를 쓰려면 “API 토큰” 화면에서 통계·분석 읽기(analytics:read)를 체크해 토큰을 발급하고 GET /api/v1/channels/{연결 id}/overview, /videos, /analytics?metrics=&dimensions=&start=&end=, /reports 를 부르세요. 지표·차원은 정해진 목록 안에서만, 기간은 최대 365일입니다.

기기 연결(도구에서 바로 연결)

업로드 도구가 연결 코드(예: ABCD-EFGH)를 보여 주면 /link 에서 코드를 넣고, 도구 이름과 요청 권한을 확인한 뒤 “승인”을 누르세요. 그 도구가 이 계정의 API 토큰을 한 번 받아 갑니다(“API 토큰” 화면에 “기기 연결”로 표시, 언제든 회수). 직접 시작하지 않은 요청이면 “거절”하세요.

6. 데이터 삭제

  • 채널만 끊기: “채널” 화면의 “연결 해제” — 구글 토큰을 회수·삭제하고 그 채널의 대기 중인 예약을 취소합니다.
  • 모두 지우기: “내 계정” 화면의 “계정 삭제” — 연결·토큰·파일·계정 정보를 모두 지웁니다. 지우기 전에 “내 데이터 내보내기”로 JSON 파일을 받아 둘 수 있습니다.
  • 메일로 요청: support@toolulah.com로 아이디와 함께 요청하세요. 7일 안에 처리합니다.
  • SNS 연결 해제 (Instagram, Facebook, Threads, TikTok): 'SNS 계정' 화면의 '연결 해제'를 누르거나, 각 SNS 설정의 '앱 및 웹사이트'(Instagram), '비즈니스 통합'(Facebook), '웹사이트 권한'(Threads)에서 이 서비스를 제거하면 접근 토큰과 연결 정보를 바로 지웁니다. 자세한 안내는 SNS 연결 해제와 데이터 삭제 안내를 보세요.

자세한 기간은 개인정보처리방침의 삭제 정책을 보세요.

7. 구글 접근 권한 회수

  1. https://myaccount.google.com/permissions 에 접속합니다.
  2. 목록에서 toolulah Upload를 고릅니다.
  3. 액세스 권한 삭제를 누릅니다.

회수하면 이 서비스는 그 채널에 더 이상 올릴 수 없습니다. 다시 쓰려면 “채널” 화면에서 다시 연결하세요.

8. 문의

박세준 · support@toolulah.com