إنشاء جلسة تشغيل مجهولة لفيديو مشترك

ينشئ بلا مصادقة جلسة لفيديو public أو unlisted حتى لا يحتاج المشاهد إلى خادم العميل. تحتفظ الجلسة بالروابط الموقعة ومرآة الحافة ومفتاح مشروط بالنبض وسياسة الموقع والرصيد، ويُحسب حد التزامن من تجزئة IP. يتحقق من المُحيل ورمز التضمين عند تفعيله، ويخفي الفيديو غير المشترك خلف 404 موحّدة.

حد المعدّل: 30 طلبًا لكل 60 ثانية لكل عنوان IP.

رموز الخطأ: invalid_body (400), video_not_found (404 — also returned when the video is private or the project has direct play off, so the endpoint leaks nothing about unshared content), embed_not_allowed (403 — the calling site is outside the referrer allowlist), embed_token_required / embed_token_invalid / embed_token_expired (403 — embed token auth is on and the supplied token is missing, malformed, or past expires), video_not_playable (409), insufficient_balance (402), embed_tokens_unconfigured (503 — the API has no EMBED_TOKEN_KEY_MASTER).

المصادقة

• لا تتطلّب هذه العملية مصادقة.

المعاملات

لا تأخذ هذه العملية أي معاملات.

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: EmbedSessionCreateRequest

{
  "videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH"
}

الاستجابات

مثال على الطلب

{
  "videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH"
}

جرّبها