> ## 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 (قناة غير مُوثَّقة)

> تُنشر مقاطع فيديو YouTube بنجاح لكن الصورة المصغّرة المخصّصة مفقودة. السبب الأكثر شيوعًا هو أن قناة YouTube غير مُوثَّقة.

عند نشر مقطع فيديو على YouTube باستخدام صورة مصغّرة مخصّصة `thumbNail`، قد يُنشر الفيديو بنجاح بينما يفشل تطبيق الصورة المصغّرة. في هذه الحالة يبقى `status` الرئيسي للمنشور بقيمة `"success"` (الفيديو منشور)، لكن نتيجة YouTube تحمل مصفوفة `warnings` تصف فشل الصورة المصغّرة:

```json theme={"system"}
{
  "status": "success",
  "id": "<videoId>",
  "thumbnail": {
    "action": "post",
    "status": "error",
    "code": 307,
    "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
    "details": "<upstream message>"
  },
  "warnings": [
    {
      "feature": "thumbnail",
      "code": 307,
      "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
      "details": "<upstream message>"
    }
  ]
}
```

## العَرَض

يظهر مقطع فيديو YouTube الخاص بك على القناة، لكن الصورة المصغّرة المخصّصة التي زوّدت بها مفقودة — يستخدم YouTube بدلًا منها إطارًا مُولَّدًا تلقائيًا. يُعيد رد API قيمة `status: "success"` مع إدخال تحذير للصورة المصغّرة (`feature: "thumbnail"`, `code: 307`).

## السبب الأكثر شيوعًا: قناة غير مُوثَّقة

السبب الأبرز لفشل الصورة المصغّرة على YouTube بالخطأ `403` هو **قناة YouTube غير مُوثَّقة**. يشترط YouTube توثيق القناة (عبر الهاتف) قبل قبول رفع صورة مصغّرة مخصّصة.

### الإصلاح: وثّق قناتك

1. انتقل إلى [https://www.youtube.com/verify](https://www.youtube.com/verify) وأكمل **التوثيق عبر الهاتف** للقناة.
2. بدلًا من ذلك، من [YouTube Studio](https://studio.youtube.com/) انتقل إلى *Settings → Channel*، واختر *Feature Eligibility*، وفعّل *Features that require phone verification*.
3. قد يستغرق YouTube ما يصل إلى 24 ساعة لتفعيل الصور المصغّرة المخصّصة بعد التوثيق. لا يعني تفعيل "توثيق الهاتف" أن YouTube سيسمح برفع الصور المصغّرة — فـ YouTube هو من يحدّد الأهلية في النهاية.
4. تأكّد من قدرتك على رفع صورة مصغّرة يدويًا في YouTube Studio. إذا لم تستطع فعل ذلك يدويًا، فلن تستطيع الـ API فعله أيضًا.

## سبب ثانوي: أذونات OAuth

إذا كانت قناتك **مُوثَّقة بالفعل** واستمرت الصور المصغّرة في الفشل بالخطأ `403`، فقد يكون حساب YouTube المرتبط يفتقر إلى الأذونات المطلوبة. جرّب **فصل حساب YouTube وإعادة ربطه** في [Social Accounts](https://app.ayrshare.com/social-accounts) ومنح جميع الأذونات المطلوبة أثناء إعادة الربط.

بالنسبة لحسابات Brand / Content Owner (التي تُستخدم غالبًا لقنوات الأعمال أو المؤسسات)، تأكّد من أن الحساب المرتبط يحمل الأذونات اللازمة — نوصي بصلاحيات "Owner" (المالك).

## متطلبات الصورة المصغّرة قبل النشر

يتحقّق Ayrshare من `thumbNail` قبل النشر حيثما أمكن. لتفادي فشل الصورة المصغّرة `307`، تأكّد من أن الصورة المصغّرة تستوفي المتطلبات التالية:

<ul class="custom-bullets">
  <li>**التنسيق:** PNG أو JPG/JPEG. يجب أن ينتهي امتداد الملف بـ <code>png</code> أو <code>jpg</code> أو <code>jpeg</code>.</li>
  <li>**الحجم:** 2 ميغابايت أو أقل.</li>
  <li>**رابط قابل للوصول:** يجب أن يكون رابط <code>thumbNail</code> متاحًا للعموم حتى يتمكن Ayrshare من جلبه.</li>
</ul>

مشكلة الصورة المصغّرة لا تُفشل المنشور أبدًا. إذا كانت الصورة المصغّرة غير صالحة بشكل قاطع (امتداد خاطئ، أو مؤكَّد أنها تتجاوز 2 ميغابايت، أو غير قابلة للوصول)، يتخطاها Ayrshare قبل رفع الفيديو، وينشر الفيديو مع ذلك، ويُبلّغ عن السبب في `warnings`. إذا لم يمكن التأكّد من الفشل إلا بعد رفع الفيديو، يبقى الفيديو منشورًا ويُعرض الفشل عبر مصفوفة `warnings` نفسها الموصوفة أعلاه. في كلتا الحالتين يُنشر الفيديو ويبقى `status` بقيمة `"success"`.

## ذات صلة

* [واجهة نشر YouTube — الصور المصغّرة](/apis/post/social-networks/youtube#youtube-thumbnails)
* [إرشادات الوسائط لـ YouTube](/media-guidelines/youtube#thumbnails)
* [أكواد الأخطاء — الكود 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)