Publique vídeo no YouTube, Instagram, Facebook e Threads

1. Prepare um ativo de vídeo pronto

Envie um vídeo local ou importe uma URL pública de vídeo para seu workspace. Confira esse envio ou importação até ficar pronto e use asset_id registrado e asset_url canônica no post.

O SosoAPI verifica o contêiner real, a duração, as dimensões e os codecs do vídeo quando a plataforma exige. Nome de arquivo, tipo MIME informado pelo chamador ou prévia reproduzível não bastam para comprovar a elegibilidade. Verifique seus direitos sobre o vídeo e o áudio e quaisquer divulgações obrigatórias antes de agendar.

• Mantenha os ativos originais de vídeo e capa no mesmo Workspace autorizado.
• Confira a elegibilidade do rascunho completo para a conta exata e o formato pretendido.
• Se a preparação falhar, consulte o status existente; não inicie importações duplicadas só porque a resposta demora.

2. Escolha o formato de vídeo do destino

Escolha o formato e as opções compatíveis com a conta de destino. Você pode reutilizar um ativo pronto, mas cada plataforma precisa do seu próprio provider_payload.

3. Agende um vídeo revisado do YouTube

Use o helper de servidor da referência da API. Substitua asset_id pelo inteiro positivo registrado e asset_url pela URL canônica. Selecione o ID real da conta do canal e um horário futuro de publicação.

Este exemplo solicita publicação pública no horário escolhido. Confirme essa visibilidade com o usuário antes de executá-lo. Defina contains_synthetic_media de acordo com o vídeo; false é apenas um exemplo. UNSCHEDULE_KEEP_PRIVATE solicita que o YouTube mantenha privado um agendamento nativo ainda não publicado se ele for cancelado.

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>"
});

• Referência da API de publicação

4. Deixe explícitos a privacidade, os Shorts e os limites do provedor

Use post_type VIDEO para o YouTube. Você pode definir surface_expectation: SHORT, mas o YouTube ainda decide se o envio é elegível como Short. Um nome de arquivo ou orientação vertical, por si só, não comprova isso.

A permissão de envio e a permissão de gerenciar agendamentos nativos são separadas. Confira se o canal oferece recursos opcionais, como miniaturas; a disponibilidade pode ser desconhecida. A referência de envio do Google explica seus requisitos de autorização e metadados, enquanto o SosoAPI também verifica seus próprios campos compatíveis e a conta conectada.

O YouTube e outras plataformas podem levar tempo para processar ou moderar um vídeo, e suas cotas continuam valendo. Um envio aceito não significa que o vídeo está publicamente visível.

• Google: referência de YouTube videos.insert
• Matriz de capacidades por conta e formato

5. Verifique o resultado final do mesmo post

Salve o ID do Scheduled Post e confira sua entrega e resultado final. Abra o link do provedor quando disponível. Agendado ou publicando significa que o resultado final ainda está pendente.

Um agendamento aceito continua no servidor se o cliente desconectar. Consulte o mesmo post antes de alterar qualquer coisa. Para cancelar, use sua versão atual e uma ação disponível de cancelamento. Excluir um vídeo já publicado segue outras regras.

Confira os requisitos de cada destino ao reutilizar um vídeo em várias plataformas. Estes exemplos mostram formatos de requisição; não executam nem publicam um vídeo nesta página.

• Fluxo de revisão com seu próprio agente
• Referência da API de publicação