YouTube, Instagram, Facebook, Threads에 동영상 게시

1. 준비된 동영상 에셋 하나 준비

로컬 동영상을 업로드하거나 공개 동영상 URL을 Workspace로 가져오세요. 업로드 또는 가져오기가 준비될 때까지 확인한 뒤 등록된 asset_id와 정식 asset_url을 게시물에 사용하세요.

플랫폼에서 요구하는 경우 SosoAPI는 동영상의 실제 컨테이너, 길이, 크기, 코덱을 검사합니다. 파일명, 호출자가 제공한 MIME 유형, 재생 가능한 미리보기만으로 적격성을 판단할 수 없습니다. 예약 전에 동영상과 오디오의 권리 및 필요한 고지를 확인하세요.

• 원본 동영상과 커버 에셋을 같은 승인된 Workspace에 유지하세요.
• 정확한 계정과 의도한 형식으로 초안 전체의 적격성을 확인하세요.
• 준비에 실패하면 기존 상태를 확인하세요. 응답이 느리다는 이유로 중복 가져오기를 시작하지 마세요.

2. 대상 동영상 형식 선택

대상 계정이 지원하는 형식과 옵션을 선택하세요. 준비된 에셋을 재사용할 수 있지만 각 플랫폼에는 자체 provider_payload가 필요합니다.

3. 검토한 YouTube 동영상 예약

API 참조의 서버 헬퍼를 사용하세요. asset_id를 등록된 양의 정수로, asset_url을 정식 URL로 바꾸세요. 채널의 실제 계정 ID와 미래 게시 시간을 선택하세요.

이 예제는 선택한 시간에 공개 게시를 요청합니다. 실행 전에 사용자에게 공개 범위를 확인받으세요. contains_synthetic_media는 동영상에 맞게 설정하세요. false는 예시일 뿐입니다. UNSCHEDULE_KEEP_PRIVATE는 게시되지 않은 네이티브 예약을 취소할 때 YouTube에 비공개 유지를 요청합니다.

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});

• 게시 API 참조

4. 개인정보, Shorts, 제공업체 제한 명시

YouTube에는 post_type VIDEO를 사용하세요. surface_expectation: SHORT를 설정할 수 있지만 업로드가 Short에 해당하는지는 YouTube가 결정합니다. 파일명이나 세로 방향만으로 판단할 수 없습니다.

업로드 권한과 네이티브 예약 관리 권한은 별개입니다. 채널이 썸네일 같은 선택 기능을 지원하는지 확인하세요. 지원 여부를 알 수 없을 수도 있습니다. Google의 업로드 참조는 인증과 메타데이터 요구 사항을 설명하며, SosoAPI는 자체 지원 필드와 연결된 계정도 확인합니다.

YouTube와 다른 플랫폼은 동영상 처리나 검토에 시간이 걸릴 수 있으며 자체 할당량도 적용됩니다. 업로드 접수가 동영상의 공개 표시를 뜻하지 않습니다.

• Google: YouTube videos.insert 참조
• 계정 및 형식 기능 매트릭스

5. 같은 게시물의 최종 결과 검증

Scheduled Post ID를 저장하고 전송과 최종 결과를 확인하세요. 가능한 제공업체 링크를 여세요. scheduled 또는 publishing은 최종 결과가 아직 대기 중임을 뜻합니다.

클라이언트 연결이 끊겨도 접수 예약은 서버에서 계속됩니다. 변경 전에 같은 게시물을 읽으세요. 취소에는 현재 버전과 가능한 취소 작업을 사용하세요. 이미 게시된 동영상 삭제는 다른 규칙을 따릅니다.

여러 플랫폼에 동영상을 재사용할 때 대상별 요구 사항을 확인하세요. 예제는 요청 형식만 보여주며 이 페이지에서 동영상을 실행하거나 게시하지 않습니다.

• 자체 에이전트 검토 흐름
• 게시 API 참조