Publikasikan video ke YouTube, Instagram, Facebook, dan Threads

1. Siapkan satu aset video yang siap

Unggah video lokal atau impor URL video publik ke ruang kerja Anda. Periksa unggahan atau impor tersebut sampai siap, lalu gunakan asset_id terdaftar dan asset_url kanonis dalam postingan.

SosoAPI memeriksa container, durasi, dimensi, dan codec video sebenarnya jika diwajibkan platform. Nama file, MIME type dari pemanggil, atau pratinjau yang dapat diputar tidak cukup untuk membuktikan kelayakan. Periksa hak Anda atas video dan audio, serta pengungkapan yang diwajibkan, sebelum menjadwalkan.

• Simpan aset video asli dan sampul dalam ruang kerja berizin yang sama.
• Periksa kelayakan draf lengkap untuk akun persis dan format yang dimaksud.
• Jika persiapan gagal, periksa status yang sudah ada; jangan memulai impor duplikat hanya karena respons lambat.

2. Pilih format video tujuan

Pilih format dan opsi yang didukung akun tujuan. Anda dapat menggunakan aset siap yang sama, tetapi setiap platform memerlukan provider_payload sendiri.

3. Jadwalkan video YouTube yang ditinjau

Gunakan helper server dari referensi API. Ganti asset_id dengan bilangan bulat positif terdaftar dan asset_url dengan URL kanonisnya. Pilih ID akun kanal sebenarnya dan waktu publikasi mendatang.

Contoh ini meminta publikasi publik pada waktu yang dipilih. Konfirmasikan visibilitas tersebut dengan pengguna sebelum menjalankannya. Atur contains_synthetic_media sesuai video; false hanya contoh. UNSCHEDULE_KEEP_PRIVATE meminta YouTube mempertahankan jadwal native yang belum dipublikasikan sebagai pribadi jika dibatalkan.

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

• Referensi API publikasi

4. Nyatakan privasi, Shorts, dan batas penyedia dengan jelas

Gunakan post_type VIDEO untuk YouTube. Anda dapat menetapkan surface_expectation: SHORT, tetapi YouTube tetap menentukan apakah unggahan memenuhi syarat sebagai Short. Nama file atau orientasi potret saja tidak dapat membuktikannya.

Izin mengunggah dan izin mengelola jadwal native terpisah. Periksa apakah kanal mendukung fitur opsional seperti thumbnail; ketersediaannya mungkin belum diketahui. Referensi unggahan Google menjelaskan persyaratan otorisasi dan metadata, sementara SosoAPI juga memeriksa kolom yang didukungnya serta akun terhubung.

YouTube dan platform lain mungkin memerlukan waktu untuk memproses atau memoderasi video, dan kuota mereka tetap berlaku. Unggahan diterima tidak berarti video terlihat publik.

• Google: Referensi YouTube videos.insert
• Matriks kemampuan akun dan format

5. Verifikasi hasil akhir postingan yang sama

Simpan ID Scheduled Post dan periksa pengiriman serta hasil akhirnya. Buka tautan penyedia jika tersedia. Scheduled atau publishing berarti hasil akhir masih tertunda.

Jadwal yang diterima berlanjut di server jika klien terputus. Baca postingan yang sama sebelum mengubah apa pun. Untuk membatalkan, gunakan versi terkini dan tindakan cancel yang tersedia. Penghapusan video yang sudah dipublikasikan mengikuti aturan berbeda.

Periksa persyaratan setiap tujuan saat menggunakan video yang sama di beberapa platform. Contoh ini menampilkan format permintaan; tidak menjalankan atau memublikasikan video dari halaman ini.

• Alur tinjauan dengan agen sendiri
• Referensi API publikasi