가이드

YouTube 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

YouTube 노드 가이드

YouTube 노드는 YouTube Data API v3를 사용하여 채널, 재생목록, 동영상을 관리할 수 있는 노드입니다. 동영상 업로드, 채널 관리, 재생목록 편집 등 YouTube 관련 작업을 워크플로우에서 자동화할 수 있습니다.

주요 기능

Channel (채널)

작업

설명

Get

채널 정보를 조회합니다

Get All

채널 목록을 가져옵니다

Update

채널 브랜딩 설정을 수정합니다

Upload Banner

채널 배너 이미지를 업로드합니다

Playlist (재생목록)

작업

설명

Create

새 재생목록을 생성합니다

Delete

재생목록을 삭제합니다

Get

재생목록 정보를 조회합니다

Get All

재생목록 목록을 가져옵니다

Update

재생목록 정보를 수정합니다

Playlist Item (재생목록 항목)

작업

설명

Add

재생목록에 동영상을 추가합니다

Delete

재생목록에서 항목을 삭제합니다

Get

재생목록 항목을 조회합니다

Get All

재생목록 항목 목록을 가져옵니다

Video (동영상)

작업

설명

Delete

동영상을 삭제합니다

Get

동영상 정보를 조회합니다

Get All

동영상 목록을 검색합니다

Rate

동영상에 좋아요/싫어요를 표시합니다

Update

동영상 정보를 수정합니다

Upload

동영상을 업로드합니다

Video Category (동영상 카테고리)

작업

설명

Get All

지역별 동영상 카테고리 목록을 가져옵니다

설정 항목

동영상 업로드 파라미터

항목

설명

Title

동영상 제목

Category ID

동영상 카테고리 (미지정 시 기본값 "People & Blogs")

Upload Source

업로드 소스 (바이너리 필드 또는 URL)

Binary Property

동영상 바이너리 데이터 필드명

Video URL

동영상 URL (URL 소스 사용 시)

동영상 업로드 옵션

항목

설명

Description

동영상 설명

Tags

태그 (쉼표로 구분)

Privacy Status

공개 설정 (public/private/unlisted)

Embeddable

임베드 허용 여부

Notify Subscribers

구독자 알림 여부

License

라이선스 유형

Default Language

기본 언어

Recording Date

촬영일

Self Declared Made For Kids

어린이용 콘텐츠 여부

예약 공개 설정

항목

설명

Publish Time Mode

공개 시간 모드 (none/relative/absolute)

Publish After Hours

현재 시간 기준 N시간 후 공개 (relative 모드)

Publish At

특정 시각에 공개 (absolute 모드)

썸네일 설정

항목

설명

Thumbnail Source

썸네일 소스 (none/url/binaryField)

Thumbnail URL

썸네일 이미지 URL

Thumbnail Binary Property

썸네일 바이너리 데이터 필드명

채널 정보 조회 파라미터

항목

설명

Channel ID

채널 ID

Part

조회할 정보 범위 (snippet, statistics, brandingSettings 등)

동영상 검색 필터

항목

설명

Query

검색 쿼리

Channel ID

특정 채널의 동영상만 검색

Region Code

지역 코드 필터

Published After/Before

게시 날짜 범위 필터

인증 정보

YouTube OAuth2 인증을 사용합니다. YouTube OAuth2 API 인증 설정을 참고하세요.

사용 예시

  1. 동영상 자동 업로드: 동영상 파일을 자동으로 YouTube에 업로드하고 메타데이터를 설정합니다.

  2. 채널 관리: 여러 채널의 통계 정보를 주기적으로 수집하여 분석합니다.

  3. 재생목록 자동 관리: 특정 조건의 동영상을 자동으로 재생목록에 추가합니다.

  4. 콘텐츠 예약 공개: 동영상을 비공개로 업로드한 후 예약 시간에 공개합니다.

  5. 동영상 메타데이터 일괄 수정: 여러 동영상의 제목, 설명, 태그를 한 번에 업데이트합니다.

참고 사항

  • 동영상 업로드는 Resumable Upload 방식을 사용하며, 대용량 파일도 안정적으로 업로드됩니다.

  • 동영상 업로드 시 URL 또는 바이너리 필드에서 파일을 가져올 수 있습니다.

  • YouTube API에는 일일 할당량(quota)이 있습니다. 동영상 업로드는 1,600 units을 소비하므로 할당량 관리에 주의하세요.

  • 설명(Description)에 포함된 꺽쇠 괄호(<, >)는 자동으로 변환됩니다.

  • 카테고리 ID를 지정하지 않으면 기본값 "22" (People & Blogs)가 사용됩니다.

  • 예약 공개 시 relative 모드로 현재 시간 기준 N시간 후를, absolute 모드로 특정 시각을 지정할 수 있습니다.

  • 업로드와 동시에 썸네일을 설정할 수 있습니다 (URL 또는 바이너리 데이터).

  • Part 필드에 *를 선택하면 모든 정보를 가져옵니다.

참고 링크