YouTube

연결 요건

youtube.upload 권한이 있고 재연결 대상으로 표시되지 않은 채널을 사용하세요. capabilities.publishPosts 또는 schedulePosts를 확인하고 비활성이라면 업로드 권한과 재연결 여부를 확인하세요. 채널과 같은 워크스페이스의 확인된 영상 하나를 사용합니다.

지원 형식

즉시 발행에는 accountIds와 youtube 객체를 사용하세요. title·mediaId·requestId·privacyStatus는 필수이며 description·madeForKids는 선택입니다. 공개 범위는 public·unlisted·private 중 하나입니다.

미디어가 필요한 형식은 업로드 가이드의 예약 → PUT → confirm을 먼저 마치세요. 완료 확인된 mediaId만 발행할 수 있습니다.

최소 발행 요청

계정·미디어 UUID는 합성 예시이므로 실제 값으로 바꾸세요. API 키는 POSTEADY_API_KEY 환경 변수로 설정합니다.

curl --request POST "https://www.posteady.com/api/v1/posts" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "youtube": {
    "requestId": "33333333-3333-4333-8333-333333333333",
    "mediaId": "22222222-2222-4222-8222-222222222222",
    "title": "A look behind the scenes",
    "description": "How we built our latest release.",
    "privacyStatus": "public",
    "madeForKids": false
  }
}'

성공 확인

HTTP 202는 작업 접수입니다. results[0].jobId를 저장하고 아래 요청으로 조회하여 status: published를 확인하세요. 예시 ID는 실제 반환값으로 바꿔야 합니다.

curl --request GET "https://www.posteady.com/api/v1/publish-jobs/44444444-4444-4444-8444-444444444444" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

예약·조회·관련 작업

예약은 같은 플랫폼 입력에 미래 scheduledAt과 선택 timezone을 추가하여 /scheduled-posts로 보내세요. 비동기 플랫폼은 UUID requestId를 새 작업마다 생성하고 재시도 때 유지합니다.

예약과 취소 · 게시물·지표 조회 · 재시도 · MCP 도구

제한과 오류

제목은 UTF-16 코드 유닛 1–100개, 설명은 최대 5,000개입니다. 영상은 MP4·QuickTime, 최대 500 MiB(524,288,000바이트)·12시간입니다. madeForKids 기본값은 false이며 콘텐츠의 대상에 맞춰 지정하세요. 리포스트·첫 댓글은 지원하지 않습니다. 작업 오류는 ACCOUNT_UNAVAILABLE·MEDIA_UNAVAILABLE·PUBLISH_QUOTA_EXCEEDED·PREPARATION_FAILED·PUBLISH_FAILED·PUBLISH_RESULT_UNKNOWN 등을 포함합니다. 결과가 불확실하면 새 요청 전에 YouTube Studio에서 발행 여부를 확인하세요.

발행 레퍼런스 · 오류 해결