YouTube API

​

النشر إلى YouTube

​

نظرة عامة على النشر

{
  // Required: Video description
  "post": "My Best YouTube Description", // empty string is allowed

  // Required: Platform to post to
  "platforms": ["youtube"],

  // Required: URL of video (only 1 allowed)
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],

  "youTubeOptions": {
    // Required: Video title (max 100 characters)
    "title": "Your Best Title"
  }
}

​

الحقول الاختيارية لمنشور YouTube

{
  // Required fields
  "post": "My Best YouTube Description", // Video description, up to 5,000 characters
  "platforms": ["youtube"], // Platform to post to
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"], // URL of video (1 allowed)

  "youTubeOptions": {
    // Required fields
    "title": "Your Best Title", // Video Title (max 100 characters)

    /** Optional Fields **/

    // Visibility: "public", "unlisted", or "private" (default: "private")
    "visibility": "private",

    // Thumbnail settings - JPEG/PNG URL under 2MB, must end in png/jpg/jpeg
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg",

    // Video organization
    "playListId": "PLrav6EfwgDX5", // Playlist ID to add the video
    "tags": ["dancing", "dogs"], // Tag array (400 chars total, 2+ chars each)

    // Video settings
    "madeForKids": false, // Self-declared kids content (default: false)
    "license": "youtube", // "youtube" (default) or "creativeCommon"
    "embeddable": true, // default: true
    "publicStatsViewable": true, // default: true
    "shorts": true, // Post as YouTube Short (max 3 minutes, adds #shorts)
    "notifySubscribers": true, // Send notification to subscribers (default: true)
    "categoryId": 24, // Video category (24 = Entertainment)
    "containsSyntheticMedia": true, // Disclose that a video contains realistic Altered or Synthetic (A/S) content

    // YouTube controlled publishing - UTC publish time. See below for details.
    "publishAt": "2022-10-08T21:18:36Z",
  }
}

• يجب أن يكون title 100 حرف أو أقل. يجب أن يكون post 5,000 حرف أو أقل. قد يحتوي post وtitle على أي أحرف باستثناء < و>.
• يمكن العثور على Playlist Id بفتح قائمة التشغيل في متصفح ونسخ القيمة بعد list=. يجب أن يكون المستخدم المُصادق والقناة هما مالك قائمة التشغيل لإضافة فيديوهات.
• إذا كان الفيديو الخاص بك لا ينتهي بامتداد فيديو معروف مثل mp4، فيُرجى استخدام معامل isVideo. راجع نقطة نهاية /post للتفاصيل.
• سيسمح حقل publishAt لـ YouTube بالتحكم في وقت النشر. سيكون الفيديو خاصًا حتى وقت النشر عندما يُجعل عامًا. إذا كان وقت النشر في الماضي، فسيُجعل الفيديو عامًا فورًا. لا تستخدم حقل المنشور scheduleDate عند استخدام حقل publishAt.
• يُستخدم حقل containsSyntheticMedia للكشف عن أن الفيديو يحتوي على محتوى واقعي مُعدَّل أو اصطناعي (A/S): جعل شخص حقيقي يبدو وكأنه يقول أو يفعل شيئًا لم يقله أو يفعله فعليًا، تعديل لقطات حدث أو مكان حقيقي، توليد مشهد واقعي المظهر لم يحدث فعليًا.
• license - يضبط نوع ترخيص الفيديو. القيم المقبولة: "youtube" (Standard YouTube License، الافتراضي) أو "creativeCommon" (Creative Commons - Attribution).
• embeddable - قيمة منطقية (أو السلاسل "true" / "false"). يتحكم فيما إذا كان يمكن تضمين الفيديو على مواقع طرف ثالث. الافتراضي: true.
• publicStatsViewable - قيمة منطقية (أو السلاسل "true" / "false"). يتحكم فيما إذا كانت لوحة الإحصائيات الموسعة على صفحة مشاهدة الفيديو مرئية للجمهور. تبقى عدد المشاهدات وعدد الإعجابات الأساسية مرئية للجمهور بغض النظر عن هذا الإعداد. الافتراضي: true. راجع status.publicStatsViewable في مرجع YouTube Data API للتفاصيل.
• راجع إرشادات وسائط YouTube لمزيد من المعلومات.

​

YouTube Shorts

​

نشر YouTube Shorts

{
  "youTubeOptions": {
    "shorts": true
  }
}

​

معلومات مهمة حول YouTube Shorts

• إرسال فيديو كـ Short هو إشارة إلى YouTube بأنك تريد أن يظهر الفيديو كـ Short، لكن ذلك لا يضمن أنه سيظهر كـ Short. يجب أن يستوفي الفيديو متطلبات فيديو Short، مثل أن يكون 3 دقائق أو أقل ونسبة عرض إلى ارتفاع عمودية 9:16 ليعتبره YouTube Short.
• لا تدعم YouTube Shorts الصور المصغرة.
• معلومات إضافية حول استخدام واجهة API لنشر YouTube Shorts.

​

صور YouTube المصغرة

​

إضافة صور YouTube المصغرة

{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

​

تمكين الصور المصغرة في YouTube Studio

​

فيديو: النشر إلى YouTube عبر واجهة API

​

حدود الرفع

• اعتمادًا على موقع منشئ المحتوى، قد تتمكن القناة من زيادة حدها اليومي بالحصول على وصول إلى الميزات المتقدمة. لمعرفة المزيد، قم بزيارة هذه المقالة.
• قد تختلف الحدود حسب البلد/المنطقة أو سجل القناة. قد تؤثر إشعارات مخالفات حقوق النشر على أهلية سجل القناة، وستؤثر إشعارات مخالفات إرشادات المجتمع على مقدار ما يمكن للقناة رفعه.

​

روابط الوصف

​

قوائم التشغيل

{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}

​

الترجمات / التسميات التوضيحية للفيديوهات

{
  "youTubeOptions": {
    "title": "My new post from Ayrshare to Youtube",
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}

• subTitleUrl: ملف SRT أو SBV صالح. يجب أن يبدأ عنوان URL بـ https:// وينتهي بـ .srt أو .sbv وأن يكون ملف SRT أو SBV صالحًا. يجب أن يكون الملف أقل من 100 ميجابايت.
• subTitleLanguage: اختياري: لغة الترجمات. يجب أن يكون رمز لغة صالحًا. الافتراضي: “en”.
• subTitleName: اختياري: اسم مسار التسميات التوضيحية. الاسم مخصص ليكون مرئيًا للمستخدم كخيار أثناء التشغيل. الحد الأقصى المدعوم لطول الاسم هو 150 حرفًا. الافتراضي: “English”.

## SRT Format Example
1
00:00:01,000 --> 00:00:04,000
Welcome to our tutorial on subtitle formats.

2
00:00:04,500 --> 00:00:08,000
Today we'll learn about SRT and SBV files.

## SBV Format Example
0:00:01.000,0:00:04.000
Welcome to our tutorial on subtitle formats.

0:00:04.500,0:00:08.000
Today we'll learn about SRT and SBV files.

​

الوسوم

{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}

​

إشارات YouTube

​

حدود الأحرف

​

نقاط نهاية إضافية