Publier des vidéos sur YouTube, Instagram, Facebook et Threads

1. Préparer une ressource vidéo prête

Téléversez une vidéo locale ou importez une URL vidéo publique dans votre espace. Suivez le téléversement ou l’importation jusqu’à disponibilité, puis utilisez l’asset_id enregistré et l’asset_url canonique dans la publication.

SosoAPI vérifie le conteneur réel, la durée, les dimensions et les codecs lorsque la plateforme l’exige. Un nom de fichier, un type MIME fourni par l’appelant ou un aperçu lisible ne suffisent pas à établir l’éligibilité. Vérifiez vos droits vidéo et audio et les mentions requises avant de programmer.

• Conservez la vidéo d’origine et les couvertures dans le même espace autorisé.
• Vérifiez l’éligibilité du brouillon complet pour le compte exact et le format prévu.
• Si la préparation échoue, examinez son statut existant ; ne démarrez pas d’importations en double simplement parce qu’une réponse tarde.

2. Choisir le format vidéo de la destination

Choisissez le format et les options pris en charge par le compte de destination. Vous pouvez réutiliser une ressource prête, mais chaque plateforme nécessite son propre provider_payload.

3. Programmer une vidéo YouTube validée

Utilisez le helper serveur de la référence API. Remplacez asset_id par l’entier positif enregistré et asset_url par son URL canonique. Sélectionnez l’identifiant réel du compte de la chaîne et une heure future.

Cet exemple demande une publication publique à l’heure choisie. Confirmez cette visibilité avec l’utilisateur avant l’exécution. Réglez contains_synthetic_media selon la vidéo ; false n’est qu’un exemple. UNSCHEDULE_KEEP_PRIVATE demande à YouTube de garder privée une programmation native non publiée si elle est annulée.

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

• Référence de l’API de publication

4. Expliciter confidentialité, Shorts et limites fournisseur

Utilisez post_type VIDEO pour YouTube. Vous pouvez définir surface_expectation: SHORT, mais YouTube décide toujours si la vidéo est un Short. Un nom de fichier ou une orientation portrait seule ne suffit pas.

L’autorisation de téléverser et celle de gérer les programmations natives sont distinctes. Vérifiez les fonctionnalités facultatives comme les miniatures ; leur disponibilité peut être inconnue. La référence de téléversement Google explique ses exigences d’autorisation et métadonnées, tandis que SosoAPI vérifie aussi ses propres champs et le compte connecté.

YouTube et les autres plateformes peuvent prendre du temps pour traiter ou modérer une vidéo, et leurs quotas s’appliquent toujours. Un téléversement accepté ne signifie pas que la vidéo est visible publiquement.

• Google : référence YouTube videos.insert
• Matrice des capacités des comptes et formats

5. Vérifier le résultat final de la même publication

Enregistrez l’identifiant Scheduled Post et vérifiez sa diffusion et son résultat final. Ouvrez le lien fournisseur lorsqu’il est disponible. Scheduled ou publishing signifie que le résultat final reste en attente.

Une programmation acceptée continue sur le serveur si le client se déconnecte. Lisez la même publication avant toute modification. Pour annuler, utilisez sa version actuelle et une action d’annulation disponible. Supprimer une vidéo déjà publiée suit d’autres règles.

Vérifiez les exigences de chaque destination quand vous réutilisez une vidéo sur plusieurs plateformes. Ces exemples montrent les formats de requête ; ils ne s’exécutent pas et ne publient aucune vidéo depuis cette page.

• Parcours de validation avec votre propre agent
• Référence de l’API de publication