> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube API

> خيارات النشر باستخدام واجهة برمجة تطبيقات YouTube

<Warning>
  يتطلب النشر على YouTube أن يحتوي حساب YouTube الخاص بك على قناة واحدة على الأقل وأن تكون مالكًا على القناة.
  لإنشاء قناة YouTube، انقر على ملفك الشخصي في لوحة تحكم YouTube واختر "Create a Channel".
  يمكنك أيضًا استخدام هذا الرابط المباشر لإنشاء قناة YouTube: [http://m.youtube.com/create\_channel](http://m.youtube.com/create_channel)

  إذا كنت تواجه مشكلات في عرض قنوات YouTube، فيُرجى الاطلاع على [دليل استكشاف أخطاء قنوات YouTube وإصلاحها](/help-center/technical-support/youtube_channels_not_showing).
</Warning>

<Info>
  قد تُعيد إخفاقات رفع YouTube رموز الأخطاء **453** (انتهاء المهلة) أو **454**
  (الخدمة غير متاحة) مع `retryAvailable: true`. يمكن لتكاملك التفرّع
  على هذه العلامة لإعادة المحاولة تلقائيًا للإخفاقات العابرة مع تأجيل تصاعدي. راجع
  [مرجع رموز الأخطاء](/errors/errors-ayrshare) للحصول على القائمة الكاملة.
</Info>

يُرجى الاطلاع على [إرشادات وسائط YouTube](/media-guidelines/youtube) و[تفويض YouTube](/dashboard/connect-social-accounts/youtube) لمزيد من المعلومات.

## النشر إلى YouTube

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

يتطلب النشر باستخدام واجهة برمجة تطبيقات YouTube كائن `youTubeOptions` مع معامل `title` — بحد أقصى 100 حرف.
الحقل `title` هو الحقل المطلوب الوحيد ويمكن توليده تلقائيًا باستخدام [نقطة نهاية التفريغ النصي](/apis/generate/transcribe-video).

على سبيل المثال، لنشر فيديو على YouTube بالإعدادات الافتراضية:

```json YouTube Post theme={"system"}
{
  // 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 افتراضيًا `private`، لكن يمكن تعيين الرؤية على `public` أو `unlisted`.
يُرجى الاطلاع على الحقول الاختيارية أدناه لمزيد من التفاصيل.

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

هناك عدة حقول اختيارية أخرى مذكورة أدناه، بما في ذلك `visibility` الفيديو و`tags` وتاريخ `publishAt`. يُرجى الاطلاع على التعليقات للاطلاع على المتطلبات والأوصاف.

```json YouTube Post Optional Fields theme={"system"}
{
  // 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",
  }
}
```

<ul class="custom-bullets">
  <li>يجب أن يكون `title` 100 حرف أو أقل. يجب أن يكون `post` 5,000 حرف أو أقل. قد يحتوي `post` و`title` على أي أحرف باستثناء \< و>.</li>
  <li>يمكن العثور على Playlist Id بفتح قائمة التشغيل في متصفح ونسخ القيمة بعد `list=`. يجب أن يكون المستخدم المُصادق والقناة هما مالك قائمة التشغيل لإضافة فيديوهات.</li>
  <li>إذا كان الفيديو الخاص بك لا ينتهي بامتداد فيديو معروف مثل mp4، فيُرجى استخدام معامل `isVideo`. راجع [نقطة نهاية /post](/apis/post/post) للتفاصيل.</li>
  <li>سيسمح حقل `publishAt` لـ YouTube بالتحكم في وقت النشر.
  سيكون الفيديو خاصًا حتى وقت النشر عندما يُجعل عامًا.
  إذا كان وقت النشر في الماضي، فسيُجعل الفيديو عامًا فورًا.
  لا تستخدم حقل المنشور `scheduleDate` عند استخدام حقل `publishAt`.</li>
  <li>يُستخدم حقل `containsSyntheticMedia` للكشف عن أن الفيديو يحتوي على محتوى واقعي مُعدَّل أو اصطناعي (A/S): جعل شخص حقيقي يبدو وكأنه يقول أو يفعل شيئًا لم يقله أو يفعله فعليًا، تعديل لقطات حدث أو مكان حقيقي، توليد مشهد واقعي المظهر لم يحدث فعليًا.</li>
  <li>`license` - يضبط نوع ترخيص الفيديو. القيم المقبولة: `"youtube"` (Standard YouTube License، الافتراضي) أو `"creativeCommon"` (Creative Commons - Attribution).</li>
  <li>`embeddable` - قيمة منطقية (أو السلاسل `"true"` / `"false"`). يتحكم فيما إذا كان يمكن تضمين الفيديو على مواقع طرف ثالث. الافتراضي: `true`.</li>
  <li>`publicStatsViewable` - قيمة منطقية (أو السلاسل `"true"` / `"false"`). يتحكم فيما إذا كانت **لوحة الإحصائيات الموسعة** على صفحة مشاهدة الفيديو مرئية للجمهور. تبقى عدد المشاهدات وعدد الإعجابات الأساسية مرئية للجمهور بغض النظر عن هذا الإعداد. الافتراضي: `true`. راجع [`status.publicStatsViewable` في مرجع YouTube Data API](https://developers.google.com/youtube/v3/docs/videos#status.publicStatsViewable) للتفاصيل.</li>
  <li>راجع [إرشادات وسائط YouTube](/media-guidelines/youtube) لمزيد من المعلومات.</li>
</ul>

<Note>
  **التحكم في تحقيق الدخل والمحتوى**

  الحقول `madeForKids` و`license` و`embeddable` و`publicStatsViewable` قابلة للضبط عبر واجهة برمجة تطبيقات Ayrshare وقت الرفع. لكن مفاتيح تحقيق الدخل المباشر (تمكين/تعطيل الإعلانات)، واختيار نوع الإعلان (pre-roll وmid-roll وpost-roll)، ومشاركة الإيرادات، وContent ID تتطلب بيانات اعتماد YouTube CMS — المتاحة فقط لـ MCNs وأصحاب المحتوى المؤسسي — و**لا تتوفر** عبر YouTube OAuth القياسية أو واجهة برمجة تطبيقات Ayrshare.
</Note>

## YouTube Shorts

YouTube Short هو فيديو عمودي قصير يمكن أن يستمر حتى ثلاث دقائق.
هذه مشابهة لفيديوهات TikTok وInstagram أو Facebook Reels.

### نشر YouTube Shorts

يمكنك نشر فيديو YouTube Shorts يصل إلى 3 دقائق بإضافة معامل `shorts` إلى كائن `youTubeOptions`.

```json YouTube Shorts Post theme={"system"}
{
  "youTubeOptions": {
    "shorts": true
  }
}
```

سيُضاف وسم <i>#shorts</i> إلى وصف YouTube.

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

<ul class="custom-bullets">
  <li>
    إرسال فيديو كـ Short هو إشارة إلى YouTube بأنك تريد أن يظهر الفيديو
    كـ Short، لكن ذلك لا يضمن أنه سيظهر كـ Short. يجب أن يستوفي الفيديو متطلبات [فيديو Short](/media-guidelines/youtube#shorts)، مثل أن يكون 3 دقائق أو أقل ونسبة عرض إلى ارتفاع عمودية 9:16 ليعتبره YouTube Short.
  </li>

  <li>لا تدعم YouTube Shorts الصور المصغرة.</li>

  <li>
    معلومات إضافية حول استخدام [واجهة API لنشر YouTube
    Shorts](https://www.ayrshare.com/blog/post-youtube-shorts-with-an-api/).
  </li>
</ul>

## صور YouTube المصغرة

<Info>
  تتطلب الصور المصغرة المخصصة **قناة YouTube موثّقة**. السبب الأكثر شيوعًا لفشل تطبيق الصورة المصغرة (بينما لا يزال الفيديو يُنشر) هو قناة غير موثّقة — تحقق على [https://www.youtube.com/verify](https://www.youtube.com/verify) (التحقق عبر الهاتف). يجب أن يكون `thumbNail` أيضًا **PNG أو JPG/JPEG**، و**2 ميجابايت أو أقل**، ومُقدَّمة من **عنوان URL يمكن الوصول إليه**؛ يتحقق Ayrshare من ذلك قبل النشر حيثما أمكن. عندما يُنشر فيديو لكن تفشل الصورة المصغرة، تحتفظ نتيجة YouTube بـ `status: "success"` وتضيف مصفوفة `warnings` (`feature: "thumbnail"`, `code: 307`) تصف الفشل. راجع [صورة YouTube المصغرة لم تُطبَّق (قناة غير موثّقة)](/help-center/technical-support/youtube_thumbnail_unverified_channel) للحل الكامل.
</Info>

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

تتطلب صور YouTube المصغرة والميزات الأخرى، مثل رفع فيديوهات مدتها 15 دقيقة، التحقق من رقم هاتفك.
`thumbNail` هو عنوان URL لصورة JPEG أو PNG بحجم أقل من 2 ميجابايت. يجب أن ينتهي امتداد الملف بـ png أو jpg أو jpeg.

```json YouTube Thumbnail theme={"system"}
{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

لا تدعم YouTube Shorts حاليًا الصور المصغرة.

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

يجب أن تُمنح أذونات YouTube لنشر الصور المصغرة. في [YouTube Studio](https://studio.youtube.com/) اذهب إلى *Settings->Channel*. اختر "*Feature Eligibility*" وانقر على "*Features that require phone verification*". أدخل رقم هاتفك للتمكين.

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/yt-thumb.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=67855a44b4ab5612d5f89df9db511556" alt="YouTube Studio" width="1200" height="781" data-path="images/apis/post/yt-thumb.webp" />

<Warning>
  قد يستغرق YouTube ما يصل إلى 24 ساعة لتمكين الصور المصغرة بعد التحقق من رقم هاتفك. يُرجى ملاحظة أن YouTube يحدد أهلية إضافة الصور المصغرة. التحقق "المُمكَّن" من الهاتف لا يضمن أن يسمح YouTube برفع الصور المصغرة.

  إذا كنت قد تم التحقق منك لمدة 24 ساعة ولا تزال لديك مشكلات، فتحقق من:

  1. أنك قادر على رفع الصور المصغرة يدويًا في YouTube Studio.
  2. إذا كنت تعمل مع Brand Content Owner Account (تستخدم غالبًا لقنوات الأعمال أو المنظمات)، فتأكد من أن لديك الأذونات اللازمة. نوصي بحقوق "Owner".
  3. إذا كنت لا تزال تواجه مشكلات، فيُرجى الاطلاع على هذا الفيديو حول [حل مشكلة الصور المصغرة](https://www.youtube.com/watch?v=1bFmX2uQk0Y).
</Warning>

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

<iframe width="380" height="200" src="https://www.youtube.com/embed/UkisNgVxubg" title="Posting to YouTube API" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />

## حدود الرفع

يقيّد YouTube عدد الفيديوهات التي يمكن لقناة رفعها في فترة 24 ساعة عبر YouTube API.

<ul class="custom-bullets">
  <li>
    اعتمادًا على موقع منشئ المحتوى، قد تتمكن القناة من زيادة حدها اليومي بالحصول
    على وصول إلى الميزات المتقدمة. لمعرفة المزيد، قم بزيارة هذه
    [المقالة](https://notifications.google.com/g/p/ACnX6LbjUElgT-OfRLVjenkpdldv6pIJ5JYGZyPGTdJwRYmo3fXFkfXJsPGnswgns0BjJ6Bjxn2bqpqfBt6gBdkLoqESKA7mqLNllzcR2qnYUJn5KlJN5jPqCWl6DGr58cZEt94mMvxXATN6_PaBR1RYEpNMTYWN).
  </li>

  <li>
    قد تختلف الحدود حسب البلد/المنطقة أو سجل القناة. قد تؤثر إشعارات مخالفات حقوق النشر
    على أهلية سجل القناة، وستؤثر [إشعارات مخالفات إرشادات
    المجتمع](https://support.google.com/youtube/answer/2802032) على مقدار ما يمكن للقناة
    رفعه.
  </li>
</ul>

إذا تلقيت خطأ حد الرفع، فيُرجى الانتظار والمحاولة مرة أخرى بعد 24 ساعة.

## روابط الوصف

يجب عليك تنشيط **Advanced Features** في YouTube Studio للحصول على روابط قابلة للنقر في وصف فيديو YouTube.

اذهب إلى **YouTube Studio -> Settings -> Channel -> Feature Eligibility -> Advanced Features -> Access Features** لتنشيط الميزات المتقدمة.

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/YT-settings.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=129f12886c2896167f936dcc7c633234" alt="YouTube Feature Eligibility" width="1000" height="661" data-path="images/apis/post/YT-settings.webp" />

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

يمكنك إضافة فيديوهات إلى قائمة تشغيل YouTube بتضمين `playListId` في كائن `youTubeOptions`.
تأكد من أن المستخدم المُصادق والقناة هما مالك قائمة التشغيل.

```json YouTube Playlist theme={"system"}
{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}
```

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

يمكنك إضافة ترجمات YouTube، المعروفة أيضًا بتسميات YouTube التوضيحية، إلى الفيديوهات بتضمين [ملف SRT](https://en.wikipedia.org/wiki/SubRip) أو ملف [SBV](https://support.google.com/youtube/answer/2734698) الخاص بـ YouTube. استخدم حقل `subTitleUrl` في كائن `youTubeOptions` لتحديد عنوان URL لملف SRT أو SBV الخاص بك.

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

<ul class="custom-bullets">
  <li>
    `subTitleUrl`: ملف SRT أو SBV صالح. يجب أن يبدأ عنوان URL بـ `https://` وينتهي بـ `.srt` أو
    `.sbv` وأن يكون ملف SRT أو SBV صالحًا. يجب أن يكون الملف أقل من 100 ميجابايت.
  </li>

  <li>
    `subTitleLanguage`: اختياري: لغة الترجمات. يجب أن يكون [رمز لغة](/iso-codes/language) صالحًا. الافتراضي: "en".
  </li>

  <li>
    `subTitleName`: اختياري: اسم مسار التسميات التوضيحية. الاسم مخصص ليكون مرئيًا
    للمستخدم كخيار أثناء التشغيل. الحد الأقصى المدعوم لطول الاسم هو 150 حرفًا.
    الافتراضي: "English".
  </li>
</ul>

<Note>
  **ما هي ملفات SRT وSBV؟**

  SRT (SubRip Subtitle) وSBV (YouTube SubViewer) هي تنسيقات ملفات ترجمة تُستخدم لعرض
  نص موقوت في الفيديوهات. الاختلاف الرئيسي هو أن SRT يستخدم الطوابع الزمنية بصيغة HH:MM:SS,MS مع
  فواصل بأسهم، بينما يستخدم SBV صيغة HH:MM:SS.MS مع فواصل.

  ```text theme={"system"}
  ## 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.
  ```
</Note>

## الوسوم

يمكنك إضافة وسوم YouTube إلى فيديوهاتك بتضمين مصفوفة `tags` في كائن `youTubeOptions`.
يجب أن يكون طول كل وسم حرفين على الأقل ويجب أن يكون الطول الإجمالي لجميع الوسوم 500 حرف أو أقل.

```json YouTube Tags theme={"system"}
{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}
```

## إشارات YouTube

بينما يمكنك إضافة `@handle` إلى منشور YouTube، لا يدعم YouTube حل الإشارات في نص المنشور.
سيبقى `@handle` كنص عادي.

## حدود الأحرف

يُرجى الاطلاع على [حدود أحرف YouTube](/help-center/technical-support/character_limits#youtube-character-limits) لمزيد من المعلومات.

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

<Card title="Get YouTube Categories" icon="code" href="/apis/utils/youtube-categories" horizontal />

<Card title="Set YouTube Watermark" icon="code" href="/apis/utils/set-youtube-watermark" horizontal />

<Card title="Remove YouTube Watermark" icon="code" href="/apis/utils/remove-youtube-watermark" horizontal />