subscriptions.csv 샘플과 컬럼 설명
Google Takeout에서 내보낸 YouTube 구독 파일의 구조를 설명합니다. 파일을 처음 받았다면 이 페이지에서 각 컬럼의 의미와 중복 제거 방식을 미리 확인하세요.
이 페이지에서 알 수 있는 것
- +subscriptions.csv의 3개 컬럼 구조
- +Channel Id, Channel Url, Channel Title의 의미
- +중복 제거에 Channel Id를 사용하는 이유
- +채널 이름에 쉼표가 포함된 경우 처리 방식
파일 구조 개요
YouTube Takeout에서 내보낸 subscriptions.csv는 첫 번째 행이 헤더이고, 이후 각 행이 구독 채널 하나를 나타냅니다. 파일 인코딩은 UTF-8 (BOM 포함 가능)이며, 컬럼은 쉼표로 구분됩니다.
헤더 행은 항상 다음과 같습니다:
Channel Id,Channel Url,Channel Title
컬럼 설명
Channel Id
채널의 고유 식별자입니다. UC로 시작하는 24자리 문자열입니다. 채널 이름이 변경되거나 URL이 바뀌어도 ID는 변하지 않습니다.
예시: UCxxxxxx1234567890AAAA
Channel Url
채널의 표준 URL입니다. Channel Id를 포함한 URL 형식이며, 브라우저에서 바로 접속할 수 있습니다.
예시: https://www.youtube.com/channel/UCxxxxxx...
Channel Title
채널의 표시 이름입니다. 채널 운영자가 언제든지 변경할 수 있으므로 중복 확인의 기준으로 사용하기에 적합하지 않습니다. 쉼표가 포함된 이름은 따옴표로 감싸진 형태로 저장됩니다.
예시: 채널 이름 / “채널 이름, 쉼표 포함”
샘플 데이터
아래는 실제 파일과 유사한 형태의 예시 데이터입니다. 마지막 행은 첫 번째 행과 같은 Channel Id를 가진 중복 예시입니다.
| Channel Id | Channel Url | Channel Title |
|---|---|---|
| UCxxxxxx1234567890AAAA | https://www.youtube.com/channel/UCxxxxxx1234567890AAAA | 채널 이름 예시 A |
| UCyyyyyy1234567890BBBB | https://www.youtube.com/channel/UCyyyyyy1234567890BBBB | 채널 이름 예시 B |
| UCzzzzzz1234567890CCCC | https://www.youtube.com/channel/UCzzzzzz1234567890CCCC | 채널 이름 예시, 쉼표 포함 |
| UCxxxxxx1234567890AAAA | https://www.youtube.com/channel/UCxxxxxx1234567890AAAA | 채널 이름 예시 A |
빨간색으로 표시된 4번째 행은 1번째 행과 Channel Id가 동일한 중복 항목입니다.
왜 Channel Id가 중복 제거의 기준인가요?
채널 이름(Channel Title)은 운영자가 바꿀 수 있고, URL도 변경되거나 리디렉션될 수 있습니다. 반면 Channel Id는 채널이 생성될 때 부여되어 변하지 않는 고유 식별자입니다.
- +채널 이름만 다르고 ID가 같은 경우 → 같은 채널, 중복
- +채널 이름이 같지만 ID가 다른 경우 → 다른 채널, 중복 아님
- +URL이 달라도 ID가 같으면 → 같은 채널 (URL 변경 케이스)
YouTube MoveKit은 Channel Id를 우선 기준으로 중복을 제거하며, ID가 없는 경우에는 Channel Url, 그것도 없으면 Channel Title을 대안으로 사용합니다.
쉼표가 포함된 채널 이름 처리
RFC 4180 CSV 규격에 따라, 쉼표나 따옴표가 포함된 필드는 큰따옴표로 감싸집니다. YouTube MoveKit은 이러한 경우를 올바르게 파싱합니다.
Channel Id,Channel Url,Channel Title UCxxxxxx,https://...,채널 이름 UCyyyyyy,https://...,"채널 이름, 쉼표 포함"
개인정보 안내
subscriptions.csv 파일에는 채널 ID, URL, 이름만 포함됩니다. 개인 식별 정보, 비밀번호, 결제 정보는 포함되지 않습니다. YouTube MoveKit에 업로드해도 파일은 브라우저에서만 처리되며 서버에 저장되지 않습니다.