تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

YouTube Data API - Errors

يحدّد هذا المستند الأنواع المختلفة من الأخطاء التي يمكن أن تعرضها عمليات YouTube Data API. يمكنك أيضًا العثور على قائمة بالأخطاء لأي طريقة فردية في المستندات المرجعية الخاصة بهذه الطريقة.

الأخطاء العامة

تحدّد الجداول التالية رسائل الخطأ في واجهة برمجة التطبيقات التي لا تتعلّق بطريقة معيّنة في واجهة برمجة التطبيقات.

`Core API errors`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	الوصول إلى هذه الصفحة محظور. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`quotaExceeded (403)`	`quotaExceeded`	لا يمكن إكمال الطلب لأنّك تجاوزت الحصة المخصّصة لك.

`Common request errors`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`incompatibleParameters`	يحدّد الطلب مَعلمتَين أو أكثر لا يمكن استخدامهما في الطلب نفسه.
`badRequest (400)`	`invalidFilters`	يحدّد الطلب معلَمة فلتر غير صالحة.
`badRequest (400)`	`invalidPageToken`	يحدّد الطلب رمزًا مميزًا غير صالح للصفحة.
`badRequest (400)`	`missingRequiredParameter`	لم يتم تحديد مَعلمة مطلوبة في الطلب.
`badRequest (400)`	`unexpectedParameter`	يحدّد الطلب مَعلمة غير متوقّعة.
`forbidden (403)`	`accountDelegationForbidden`	لا يمكن للمستخدم الذي تمت مصادقته اتخاذ إجراء نيابةً عن حساب Google المحدّد.
`forbidden (403)`	`authenticatedUserAccountClosed`	تم إغلاق حساب YouTube الخاص بالمستخدم الذي تمّت المصادقة عليه. في حال كان المستخدم الذي تمت مصادقته يتصرّف نيابةً عن حساب Google آخر، يشير هذا الخطأ إلى الحساب الأخير.
`forbidden (403)`	`authenticatedUserAccountSuspended`	تم تعليق حساب YouTube الخاص بالمستخدم الذي تمّت المصادقة عليه. في حال كان المستخدم الذي تمت مصادقته يتصرّف نيابةً عن حساب Google آخر، يشير هذا الخطأ إلى الحساب الأخير.
`forbidden (403)`	`authenticatedUserNotChannel`	بالنسبة إلى هذا الطلب، يجب أن يحلّ المستخدم الذي تمت مصادقته محلّ قناة، ولكنّه لا يفعل ذلك. إذا تمت مصادقة طلبك وكان يستخدم مَعلمة التفويض `onBehalfOfContentOwner`، يجب أيضًا ضبط المَعلمة `onBehalfOfContentOwnerChannel`.
`forbidden (403)`	`channelClosed`	تم إغلاق القناة المحدّدة في الطلب.
`forbidden (403)`	`channelNotFound`	يتعذّر العثور على القناة المحدّدة في الطلب.
`forbidden (403)`	`channelSuspended`	تم تعليق القناة المحدّدة في الطلب.
`forbidden (403)`	`cmsUserAccountNotFound`	لا يُسمح لمستخدم نظام إدارة المحتوى باتّخاذ إجراء نيابةً عن مالك المحتوى المحدّد.
`forbidden (403)`	`insufficientCapabilities`	لا يملك مستخدم نظام إدارة المحتوى (CMS) إمكانات كافية.
`forbidden (403)`	`insufficientPermissions`	يحدّد رمز OAuth 2.0 المقدَّم للطلب نطاقات غير كافية للوصول إلى البيانات المطلوبة.
`notFound (404)`	`contentOwnerAccountNotFound`	لم يتم العثور على حساب مالك المحتوى المحدّد.

`Request context errors`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`invalidLanguage`	لا تحدّد قيمة المَعلمة `hl` رمز لغة صالحًا.
`badRequest (400)`	`invalidMine`	استخدام الطلب للمَعلمة `mine` غير متاح.
`badRequest (400)`	`invalidMine`	لا يمكن استخدام المَعلمة `mine` في الطلبات التي يكون فيها المستخدم الذي تمت مصادقته شريكًا في YouTube. يجب إزالة المَعلمة `mine` أو المصادقة كمستخدم YouTube من خلال إزالة المَعلمة `onBehalfOfContentOwner` أو العمل كإحدى قنوات الشريك من خلال تقديم المَعلمة `onBehalfOfContentOwnerChannel` إذا كانت متاحة للطريقة التي تم استدعاؤها.
`badRequest (400)`	`invalidPart`	تحدّد المَعلمة `part` في الطلب بعض الأجزاء التي لا يمكن كتابتها في الوقت نفسه.
`badRequest (400)`	`invalidRegionCode`	تحدّد المَعلمة `regionCode` رمز منطقة غير صالح.
`badRequest (400)`	`unexpectedPart`	تحدّد المَعلمة `part` في الطلب قيمة غير متوقّعة.
`badRequest (400)`	`unknownPart`	تحدّد المَعلمة `part` في الطلب قيمة غير معروفة.
`badRequest (400)`	`unsupportedLanguageCode`	لا تحدّد قيمة المَعلمة `hl` رمز لغة متوافقًا.
`badRequest (400)`	`unsupportedRegionCode`	تحدّد المَعلمة `regionCode` رمز منطقة غير متوافق.
`unauthorized (401)`	`authorizationRequired`	يستخدم الطلب المَعلمة `mine` ولكن لم يتمّ تفويضه بشكل صحيح.
`unauthorized (401)`	`youtubeSignupRequired`	يشير هذا الخطأ إلى أنّ المستخدم لديه حساب Google غير مرتبط، ما يعني أنّ المستخدم لديه حساب Google ولكن ليس لديه قناة على YouTube. يمكن لهؤلاء المستخدمين الوصول إلى العديد من الميزات التي تعتمد على إذن المستخدم، مثل تقييم الفيديوهات أو إضافتها إلى قائمة تشغيل `watch_later`. ومع ذلك، على سبيل المثال، يحتاج المستخدم إلى قناة على YouTube ليتمكّن من تحميل فيديو. إنّ المستخدم الذي لديه حساب Gmail أو جهاز Android لديه بالتأكيد حساب على Google، ولكن قد لا يكون قد ربط حساب Google هذا بقناة على YouTube. يظهر هذا الخطأ عادةً إذا حاولت استخدام مسار حساب الخدمة OAuth 2.0. لا يتيح YouTube استخدام حسابات الخدمة، وإذا حاولت المصادقة باستخدام حساب خدمة، سيظهر لك هذا الخطأ. يتناول منشور مدونة YouTube API الذي يقدّم ميزة استخدام حساب Google الخطأ `youtubeSignupRequired` بتفصيل أكبر. على الرغم من أنّ مشاركة المدوّنة تشرح الخطأ في الإصدار 2.1 من واجهة برمجة التطبيقات، إلا أنّ معنى الخطأ لا يزال ساريًا.

الأنشطة

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد activities. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`activities.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`homeParameterDeprecated`	لا تتوفّر بيانات نشاط الصفحة الرئيسية للمستخدم من خلال واجهة برمجة التطبيقات هذه. قد يحدث هذا الخطأ إذا ضبطت المَعلمة `home` على `true` في طلب غير مصرَّح به.
`forbidden (403)`	`forbidden`	الطلب غير مصرَّح به بشكل صحيح.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على رقم تعريف القناة المحدّد بواسطة المَعلمة `channelId` في الطلب.
`notFound (404)`	`homeChannelNotFound`	يتعذّر العثور على خلاصة صفحة YouTube الرئيسية للمستخدم الذي تمت مصادقته حاليًا.
`unauthorized (401)`	`authorizationRequired`	يستخدم الطلب المَعلمة `home` ولكن لم يتمّ تفويضه بشكل صحيح.

مقاطع الترجمة والشرح

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد captions. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`captions.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	الأذونات المرتبطة بالطلب غير كافية لحذف مسار الترجمة والشرح. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`notFound (404)`	`captionNotFound`	تعذَّر العثور على مسار الترجمة والشرح. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`captions.download`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	الأذونات المرتبطة بالطلب غير كافية لتنزيل مسار الترجمة والشرح. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`invalidValue (400)`	`couldNotConvert`	تعذّر تحويل بيانات مسار الترجمة والشرح إلى اللغة و/أو التنسيق المطلوبَين. تأكَّد من أنّ قيمتَي `tfmt` و`tlang` المطلوبتَين صالحتان، وأنّ `snippet.status` لمسار الترجمة والشرح المطلوب ليس `failed`.
`notFound (404)`	`captionNotFound`	تعذَّر العثور على مسار الترجمة والشرح. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`captions.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`contentRequired`	لا يحتوي الطلب على محتوى مسار الترجمة والشرح.
`conflict (409)`	`captionExists`	يتضمّن الفيديو المحدّد مسار ترجمة وشرح مع `snippet.language` و`snippet.name` المحدّدَين. يمكن أن يتضمّن الفيديو مسارات متعددة للغة نفسها، ولكن يجب أن يكون لكل مسار اسم مختلف. هناك طرق متعددة لحلّ هذا الخطأ. يمكنك حذف المسار الحالي ثم إدراج مسار جديد أو تغيير اسم المسار الجديد قبل إدراجه.
`forbidden (403)`	`forbidden`	الأذونات المرتبطة بالطلب غير كافية لتحميل مسار الترجمة والشرح. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`invalidValue (400)`	`invalidMetadata`	يحتوي الطلب على قيم بيانات وصفية غير صالحة، ما يمنع إنشاء المسار. تأكَّد من أنّ الطلب يحدّد قيمًا صالحة للسمات `snippet.language` و`snippet.name` و`snippet.videoId`. يمكن أيضًا تضمين السمة `snippet.isDraft`، ولكنّها ليست مطلوبة.
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تم تحديده من خلال المَعلمة `videoId`.
`invalidValue (400)`	`nameTooLong`	‫`snippet.name` المحدّد في الطلب طويل جدًا. الحد الأقصى للطول المسموح به هو 150 حرفًا.

`captions.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	تعذّر استرداد مسار ترجمة وشرح واحد أو أكثر لأنّ الأذونات المرتبطة بالطلب غير كافية لاسترداد الموارد المطلوبة. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`notFound (404)`	`captionNotFound`	لم يتم العثور على مسار ترجمة وشرح واحد أو أكثر من مسارات الترجمة والشرح المحدّدة. يحدث هذا الخطأ إذا كانت المَعلمة `videoId` تحدّد فيديو فعليًا، ولكن المَعلمة `id` تحدّد معرّفات مسارات ترجمة غير موجودة أو معرّفات مسارات مرتبطة بفيديوهات أخرى. تحقَّق من قيم مَعلمتَي `id` و`videoId` في الطلب للتأكّد من صحتها.
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تم تحديده من خلال المَعلمة `videoId`.

`captions.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`contentRequired`	لم يحمّل الطلب ملف ترجمة وشرح معدَّل. يجب توفير محتوى المسار الفعلي إذا تم ضبط المَعلمة `sync` على `true`.
`forbidden (403)`	`forbidden`	الأذونات المرتبطة بالطلب غير كافية لتعديل مسار الترجمة والشرح. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`notFound (404)`	`captionNotFound`	تعذّر العثور على مسار الترجمة والشرح المحدّد. تحقَّق من قيمة مَعلمة `id` في الطلب للتأكّد من صحتها.

channelBanners

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد channelBanners. يمكن أن تعرض هذه الطرق أيضًا الأخطاء المُدرَجة في قسم أخطاء الطلبات الشائعة.

`channelBanners.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`bannerAlbumFull`	يحتوي ألبوم "صورة قناة YouTube" على عدد كبير جدًا من الصور. يُرجى الانتقال إلى http://photos.google.com، ثم إلى صفحة الألبومات، وإزالة بعض الصور من ذلك الألبوم.
`badRequest (400)`	`mediaBodyRequired`	لا يتضمّن الطلب محتوى الصورة.

channelSections

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد channelSections. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`channelSections.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`notEditable`	لا يمكن حذف قسم القناة هذا.
`forbidden (403)`	`channelSectionForbidden`	لم يتم إثبات صحة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة.
`invalidValue (400)`	`idInvalid`	تحدّد السمة `id` معرّفًا غير صالح لقسم القناة.
`invalidValue (400)`	`idRequired`	يجب أن تحدّد السمة `id` قيمة تعرّف قسم القناة الذي يتم حذفه.
`notFound (404)`	`channelNotFound`	لم يتم العثور على القناة.
`notFound (404)`	`channelSectionNotFound`	تعذّر العثور على قسم القناة الذي تحاول تعديله.

`channelSections.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSetError`	يجب ضبط السمة `snippet.defaultLanguage` الخاصة بمورد `channelSection` لإدراج عنصر `localizations` لهذا المورد أو تعديله بنجاح.
`badRequest (400)`	`invalidLanguage`	تعذّر التحقّق من صحة أحد مفاتيح اللغة الخاصة بالعنصر `localizations`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع `channelSections`.
`badRequest (400)`	`notEditable`	يتعذّر إنشاء قسم القناة هذا.
`badRequest (400)`	`styleRequired`	يجب أن يحدّد المرجع `channelSection` قيمة للحقل `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	تعذّر التحقّق من صحة إحدى القيم في قائمة `targeting.countries`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات المرجع `channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	تعذّر التحقّق من صحة إحدى القيم في قائمة `targeting.languages`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع `channelSections`.
`badRequest (400)`	`targetInvalidRegion`	تعذّر التحقّق من صحة إحدى القيم في القائمة `targeting.regions`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات المرجع `channelSections`.
`badRequest (400)`	`typeRequired`	يجب أن يحدّد مورد `channelSection` قيمة لحقل `snippet.type`.
`forbidden (403)`	`channelSectionForbidden`	لم يتم إثبات صحة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة.
`invalidValue (400)`	`channelNotActive`	هناك قناة واحدة على الأقل من القنوات المحدّدة غير نشطة.
`invalidValue (400)`	`channelsDuplicated`	تعذَّرت تلبية الطلب لأنّه حدّد قنوات مكرّرة.
`invalidValue (400)`	`channelsNeeded`	إذا كانت قيمة السمة `snippet.type` هي `multipleChannels`، يجب تحديد السمة `contentDetails.channels[]` وتحديد قناة واحدة على الأقل.
`invalidValue (400)`	`channelsNotExpected`	قدّم المرجع الذي تم توفيره مع الطلب قيمة للسمة `contentDetails.channels[]`، ولكن لا يُتوقّع توفّر قنوات لهذا النوع من أقسام القنوات.
`invalidValue (400)`	`contentDetailsNeeded`	يجب أن يحتوي المرجع الذي تريد إدراجه على عنصر `contentDetails` لهذا النوع من أقسام القنوات.
`invalidValue (400)`	`inValidPosition`	تحتوي السمة `snippet.position` على قيمة غير صالحة.
`invalidValue (400)`	`maxChannelSectionExceeded`	لا يمكن إكمال الطلب لأنّ القناة تحتوي حاليًا على الحد الأقصى المسموح به لعدد أقسام القناة.
`invalidValue (400)`	`maxChannelsExceeded`	تعذَّر تنفيذ الطلب لأنّه حاول تضمين عدد كبير جدًا من القنوات في قسم القناة.
`invalidValue (400)`	`maxPlaylistExceeded`	تعذَّر تنفيذ الطلب لأنّه حاول تضمين عدد كبير جدًا من قوائم التشغيل في قسم القناة.
`invalidValue (400)`	`onePlaylistNeeded`	إذا كانت قيمة السمة `snippet.type` هي `singlePlaylist`، يجب أن تحدّد السمة `contentDetails.playlists[]` قائمة تشغيل واحدة بالضبط.
`invalidValue (400)`	`ownChannelInChannels`	لا يمكنك تضمين قناتك في قسم قنوات يظهر على تلك القناة.
`invalidValue (400)`	`playlistIsPrivate`	قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحدّدة خاصة، وبالتالي لا يمكن تضمينها في قسم القناة.
`invalidValue (400)`	`playlistsDuplicated`	تعذَّرت تلبية الطلب لأنّه حدّد قوائم تشغيل مكرّرة.
`invalidValue (400)`	`playlistsNeeded`	إذا كانت قيمة السمة `snippet.type` هي `singlePlaylist` أو `multiplePlaylists`، يجب تحديد السمة `contentDetails.playlists[]`.
`invalidValue (400)`	`playlistsNotExpected`	حدّد المورد الذي تم توفيره مع الطلب قيمة للسمة `contentDetails.playlists[]`، ولكن لا يُتوقع توفُّر قوائم تشغيل لهذا النوع من أقسام القناة.
`invalidValue (400)`	`snippetNeeded`	يجب تحديد `snippet` لإنشاء قسم القناة.
`invalidValue (400)`	`titleLengthExceeded`	قيمة السمة `snippet.title` طويلة جدًا.
`invalidValue (400)`	`titleRequired`	إذا كانت قيمة السمة `snippet.type` هي `multiplePlaylists` أو `multipleChannels`، يجب ضبط عنوان القسم من خلال تحديد قيمة للسمة `snippet.title`.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على قناة واحدة أو أكثر من القنوات المحدّدة.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحدّدة.

`channelSections.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`channelSectionForbidden`	لا يُسمح لمقدّم الطلب بالوصول إلى أقسام القناة المطلوبة.
`invalidValue (400)`	`idInvalid`	يحدّد الطلب معرّفًا غير صالح لقسم القناة.
`invalidValue (400)`	`invalidCriteria`	تعذّر إكمال الطلب لأنّ معايير الفلتر غير صالحة.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على القناة المرتبطة بالطلب.
`notFound (404)`	`channelSectionNotFound`	يتعذّر العثور على قسم القناة المرتبط بالطلب.

`channelSections.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSetError`	يجب ضبط السمة `snippet.defaultLanguage` الخاصة بمورد `channelSection` لإدراج عنصر `localizations` لهذا المورد أو تعديله بنجاح.
`badRequest (400)`	`invalidLanguage`	تعذّر التحقّق من صحة أحد مفاتيح اللغة الخاصة بالعنصر `localizations`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع `channelSections`.
`badRequest (400)`	`notEditable`	لا يمكن تعديل قسم القناة هذا.
`badRequest (400)`	`styleRequired`	يجب أن يحدّد مورد `channelSection` قيمة لحقل `snippet.style`.
`badRequest (400)`	`targetInvalidCountry`	تعذّر التحقّق من صحة إحدى القيم في قائمة `targeting.countries`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات المرجع `channelSections`.
`badRequest (400)`	`targetInvalidLanguage`	تعذّر التحقّق من صحة إحدى القيم في قائمة `targeting.languages`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع `channelSections`.
`badRequest (400)`	`targetInvalidRegion`	تعذّر التحقّق من صحة إحدى القيم في قائمة `targeting.regions`. استخدِم طريقة channelSections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع `channelSections`.
`badRequest (400)`	`typeRequired`	يجب أن يحدّد مورد `channelSection` قيمة للحقل `snippet.type`.
`forbidden (403)`	`channelSectionForbidden`	لم يتم إثبات صحة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة.
`invalidValue (400)`	`channelNotActive`	هناك قناة واحدة على الأقل من القنوات المحدّدة غير نشطة.
`invalidValue (400)`	`channelsDuplicated`	تعذَّرت تلبية الطلب لأنّه حدّد قنوات مكرّرة.
`invalidValue (400)`	`channelsNeeded`	إذا كانت قيمة السمة `snippet.type` هي `multipleChannels`، يجب تحديد السمة `contentDetails.channels[]` وتحديد قناة واحدة على الأقل.
`invalidValue (400)`	`channelsNotExpected`	حدّد المورد الذي تم توفيره مع الطلب قيمة للسمة `contentDetails.channels[]`، ولكن لا يُتوقّع توفّر قنوات لهذا النوع من أقسام القناة.
`invalidValue (400)`	`contentDetailsNeeded`	يجب أن يحتوي المورد الذي تعدّله على عنصر `contentDetails` لهذا النوع من أقسام القناة.
`invalidValue (400)`	`idInvalid`	تحدّد السمة `id` معرّفًا غير صالح لقسم القناة.
`invalidValue (400)`	`idRequired`	يجب أن تحدّد السمة `id` قيمة تعرّف قسم القناة الذي يتم تعديله.
`invalidValue (400)`	`inValidPosition`	تحتوي السمة `snippet.position` على قيمة غير صالحة.
`invalidValue (400)`	`maxChannelsExceeded`	تعذَّرت تلبية الطلب لأنّه حاول تضمين عدد كبير جدًا من القنوات في قسم القنوات.
`invalidValue (400)`	`maxPlaylistExceeded`	تعذَّر تنفيذ الطلب لأنّه حاول تضمين عدد كبير جدًا من قوائم التشغيل في قسم القناة.
`invalidValue (400)`	`onePlaylistNeeded`	إذا كانت قيمة السمة `snippet.type` هي `singlePlaylist`، يجب أن تحدّد السمة `contentDetails.playlists[]` قائمة تشغيل واحدة بالضبط.
`invalidValue (400)`	`ownChannelInChannels`	لا يمكنك تضمين قناتك في قسم قنوات يظهر على تلك القناة.
`invalidValue (400)`	`playlistIsPrivate`	قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحدّدة خاصة، وبالتالي لا يمكن تضمينها في قسم القناة.
`invalidValue (400)`	`playlistsDuplicated`	تعذَّرت تلبية الطلب لأنّه حدّد قوائم تشغيل مكرّرة.
`invalidValue (400)`	`playlistsNeeded`	إذا كانت قيمة السمة `snippet.type` هي `singlePlaylist` أو `multiplePlaylists`، يجب تحديد السمة `contentDetails.playlists[]`.
`invalidValue (400)`	`playlistsNotExpected`	حدّد المورد الذي تم توفيره مع الطلب قيمة للسمة `contentDetails.playlists[]`، ولكن لا يُتوقع توفُّر قوائم تشغيل لهذا النوع من أقسام القناة.
`invalidValue (400)`	`snippetNeeded`	يجب تحديد `snippet` لتعديل قسم القناة.
`invalidValue (400)`	`titleLengthExceeded`	قيمة السمة `snippet.title` طويلة جدًا.
`invalidValue (400)`	`titleRequired`	إذا كانت قيمة السمة `snippet.type` هي `multiplePlaylists` أو `multipleChannels`، يجب ضبط عنوان القسم من خلال تحديد قيمة للسمة `snippet.title`.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على قناة واحدة أو أكثر من القنوات المحدّدة.
`notFound (404)`	`channelSectionNotFound`	يتعذّر العثور على قسم القناة الذي تحاول تعديله.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة تشغيل واحدة أو أكثر من قوائم التشغيل المحدّدة.

قنوات

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد channels. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`channels.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`invalidCriteria`	يمكن تحديد فلتر واحد كحد أقصى من الفلاتر التالية:`id` أو `mySubscribers` أو `categoryId` أو `mine` أو `managedByMe` أو `forUsername`. في حال مصادقة مالك المحتوى باستخدام المَعلمة `onBehalfOfContentOwner`، يمكن تحديد `id` أو `managedByMe` فقط.
`forbidden (403)`	`channelForbidden`	لا تتوافق القناة المحدّدة بواسطة المَعلمة `id` مع الطلب أو أنّ الطلب غير مصرّح به بشكل صحيح.
`notFound (404)`	`categoryNotFound`	يتعذّر العثور على الفئة التي تم تحديدها من خلال المَعلمة `categoryId`.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على القناة المحدّدة في المَعلمة `id`.

`channels.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`brandingValidationError`	تعذّر التحقّق من صحة إحدى القيم في عنصر `brandingSettings`. استخدِم الطريقة `channels.list` لاسترداد الإعدادات الحالية للقناة، وعدِّل قيم السمات باتّباع الإرشادات الواردة في مستندات المرجع `channels`.
`badRequest (400)`	`channelTitleUpdateForbidden`	عند تعديل `brandingSettings part` لقناة، يجب ضبط قيمة السمة `brandingSettings.channel.title` على العنوان الحالي للقناة أو حذف السمة. تعرض واجهة برمجة التطبيقات خطأً إذا غيّرت قيمة السمة.
`badRequest (400)`	`defaultLanguageNotSetError`	يجب ضبط `defaultLanguage` لتحديث `localizations`.
`badRequest (400)`	`invalidBrandingOption`	أحد إعدادات العلامة التجارية التي حدّدتها غير متوفّر. استخدِم طريقة `channels.list` لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع `channels`.
`badRequest (400)`	`invalidCustomMessage`	تحدّد البيانات الوصفية للطلب رسالة مخصّصة غير صالحة. تحقَّق من قيمة السمة `invideoPromotion.items[].customMessage` في المورد الذي أرسله الطلب.
`badRequest (400)`	`invalidDuration`	تحدّد البيانات الوصفية للطلب مدة غير صالحة في الجزء invideoPromotion.
`badRequest (400)`	`invalidDuration`	تحدّد البيانات الوصفية للطلب نوع موضع غير صالح لتحديد كيفية وضع العنصر الذي يتم الترويج له في مشغّل الفيديو. تحقَّق من قيمة السمة `invideoPromotion.position.type` في المورد الذي أرسل الطلب.
`badRequest (400)`	`invalidRecentlyUploadedBy`	تحدّد البيانات الوصفية للطلب معرّف قناة غير صالح. تحقَّق من قيمة السمة `invideoPromotion.items[].id.recentlyUploadedBy` في المورد الذي أرسله الطلب.
`badRequest (400)`	`invalidTimingOffset`	تحدّد البيانات الوصفية للطلب إزاحة توقيت غير صالحة في الجزء invideoPromotion.
`badRequest (400)`	`invalidTimingOffset`	تحدّد البيانات الوصفية للطلب إزاحة توقيت غير صالحة لتحديد وقت عرض العنصر الذي يتم الترويج له في مشغّل الفيديو. تحقَّق من قيمة السمة `invideoPromotion.timing.offsetMs` في المورد الذي أرسله الطلب.
`badRequest (400)`	`invalidTimingType`	تحدّد البيانات الوصفية للطلب طريقة توقيت غير صالحة لتحديد وقت عرض العنصر الذي يتم الترويج له في مشغّل الفيديو. تحقَّق من قيمة السمة `invideoPromotion.timing.type` في المورد الذي أرسله الطلب.
`badRequest (400)`	`localizationValidationError`	تعذّر التحقّق من صحة إحدى القيم في عنصر الترجمات. استخدِم طريقة channels.list لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع قنوات YouTube.
`badRequest (400)`	`tooManyPromotedItems`	تم تجاوز عدد الفيديوهات المسموح بالترويج لها في الجزء invideoPromotion.
`forbidden (403)`	`channelForbidden`	لا تتوافق القناة المحدّدة في المَعلمة `id` مع الطلب أو أنّ الطلب غير مصرّح به بشكل صحيح.
`forbidden (403)`	`promotedVideoNotAllowed`	تعذّر العثور على القناة التي يحاول طلب بيانات من واجهة برمجة التطبيقات تعديلها. تحقَّق من قيمة السمة `id` في مورد `channel` الذي أرسله الطلب للتأكّد من صحة معرّف القناة.
`forbidden (403)`	`websiteLinkNotAllowed`	عنوان URL للموقع الإلكتروني المحدّد غير مسموح به.
`notFound (404)`	`channelNotFound`	تعذّر العثور على القناة المحدّدة من خلال المَعلمة `id` أو لا تتوفّر فيها خيارات الهوية البصرية.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على القناة المحدّدة في المَعلمة `id`.
`notFound (404)`	`unknownChannelId`	لم يتم العثور على معرّف القناة المحدّد.
`notFound (404)`	`unknownChannelId`	لم يتم العثور على معرّف القناة recentlyUploadedBy المحدّد.
`notFound (404)`	`unknownVideoId`	يتعذّر العثور على معرّف الفيديو المحدّد كعنصر مروَّج.
`required (400)`	`requiredItemIdType`	يجب أن تحدّد البيانات الوصفية للطلب نوع عنصر في جزء invideoPromotion.
`required (400)`	`requiredItemId`	يجب أن تحدّد البيانات الوصفية للطلب عنصرًا في الجزء invideoPromotion.
`required (400)`	`requiredTimingOffset`	يجب أن تحدّد البيانات الوصفية للطلب إزاحة توقيت تلقائية لكي يتمكّن YouTube من تحديد وقت عرض العنصر الذي يتم الترويج له. اضبط قيمة السمة `invideoPromotion.defaultTiming.offsetMs` في المورد الذي يرسله الطلب.
`required (400)`	`requiredTimingOffset`	يجب أن تحدّد البيانات الوصفية للطلب إزاحة التوقيت لكي يتمكّن YouTube من تحديد وقت عرض العنصر الذي يتم الترويج له. اضبط قيمة السمة `invideoPromotion.timing.offsetMs` في المورد الذي يرسله الطلب.
`required (400)`	`requiredTimingType`	يجب أن تحدّد البيانات الوصفية للطلب طريقة تحديد التوقيت لكي يتمكّن YouTube من تحديد وقت عرض المنتج الترويجي. اضبط قيمة السمة `invideoPromotion.defaultTiming.type` في المورد الذي يرسله الطلب.
`required (400)`	`requiredTimingType`	يجب أن تحدّد البيانات الوصفية للطلب طريقة تحديد التوقيت لكي يتمكّن YouTube من تحديد وقت عرض المنتج الترويجي. اضبط قيمة السمة `invideoPromotion.timing.type` في المورد الذي يرسله الطلب.
`required (400)`	`requiredTiming`	يجب أن تحدّد البيانات الوصفية للطلب توقيتًا لكل عنصر في الجزء `invideoPromotion`.
`required (400)`	`requiredVideoId`	يجب أن تحدّد البيانات الوصفية للطلب معرّف الفيديو لتحديد السلعة التي يتم الترويج لها.
`required (400)`	`requiredWebsiteUrl`	يجب أن تحدّد البيانات الوصفية للطلب عنوان URL لموقع إلكتروني في الجزء invideoPromotion. اضبط قيمة السمة `invideoPromotion.items[].id.websiteUrl` في المورد الذي يرسله الطلب.

commentThreads

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد commentThreads. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`commentThreads.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`operationNotSupported`	طلب البيانات من واجهة برمجة التطبيقات غير صالح أو تم تنسيقه بشكل غير صحيح. وبالتالي، لم يتمكَّن خادم واجهة برمجة التطبيقات من فهم الطلب.
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. تحقَّق من بنية مورد `commentThread` في نص الطلب للتأكّد من أنّه صالح.
`forbidden (403)`	`commentsDisabled`	تم إيقاف ميزة التعليقات على الفيديو الذي تم تحديده من خلال المَعلمة `videoId`.
`forbidden (403)`	`forbidden`	يتعذّر استرداد سلسلة تعليقات واحدة أو أكثر من سلاسل التعليقات المطلوبة بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`notFound (404)`	`channelNotFound`	تعذّر العثور على القناة المحدّدة بواسطة المَعلمة `allThreadsRelatedToChannelId`.
`notFound (404)`	`commentThreadNotFound`	يتعذّر العثور على سلسلة تعليقات واحدة أو أكثر من سلاسل التعليقات المحدّدة. تحقَّق من قيم المَعلمة `id` للطلب للتأكّد من صحتها.
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تحدّده المَعلمة `videoId`.

`commentThreads.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`channelOrVideoIdMissing`	يجب ربط كل سلسلة تعليقات بقناة أو فيديو. تأكَّد من أنّ المورد يحدّد قيمًا لكل من السمتَين `snippet.channelId` و`snippet.videoId`. يظهر التعليق على الفيديو في صفحة مشاهدة الفيديو.
`badRequest (400)`	`commentTextRequired`	يجب أن يحدّد مورد `comment` الذي يتم إدراجه قيمة للسمة `snippet.topLevelComment.snippet.textOriginal`. لا يمكن ترك حقل التعليقات فارغًا.
`badRequest (400)`	`commentTextTooLong`	يحتوي المورد `comment` الذي يتم إدراجه على عدد كبير جدًا من الأحرف في السمة `snippet.topLevelComment.snippet.textOriginal`.
`badRequest (400)`	`invalidCommentThreadMetadata`	البيانات الوصفية للطلب غير صالحة.
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. تحقَّق من بنية مورد `commentThread` في نص الطلب للتأكّد من صلاحيته.
`forbidden (403)`	`forbidden`	تعذّر إنشاء سلسلة تعليقات بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`forbidden (403)`	`ineligibleAccount`	يجب دمج حساب YouTube المستخدَم لمنح الإذن بطلب البيانات من واجهة برمجة التطبيقات مع حساب المستخدم على Google لإدراج تعليق أو سلسلة تعليقات.
`notFound (404)`	`channelNotFound`	تعذّر العثور على القناة المحدّدة. تحقَّق من قيمة السمة `snippet.channelId` للتأكّد من صحتها.
`notFound (404)`	`videoNotFound`	تعذَّر العثور على الفيديو المحدّد. تحقَّق من قيمة السمة `snippet.videoId` للتأكّد من صحتها.

comments

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد comments. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`comments.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`operationNotSupported`	طلب البيانات من واجهة برمجة التطبيقات غير صالح أو تم تنسيقه بشكل غير صحيح. وبالتالي، لم يتمكَّن خادم واجهة برمجة التطبيقات من فهم الطلب.
`forbidden (403)`	`forbidden`	يتعذّر استرداد تعليق واحد أو أكثر من التعليقات المطلوبة بسبب عدم كفاية الأذونات. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`notFound (404)`	`commentNotFound`	يتعذّر العثور على تعليق واحد أو أكثر من التعليقات المحدّدة. تحقَّق من قيم مَعلمتَي `id` و`parentId` في الطلب للتأكّد من صحتها.

`comments.setModerationStatus`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`banWithoutReject`	لا يمكن استخدام المَعلمة `banAuthor` إلا إذا كانت قيمة المَعلمة `moderationStatus` هي `rejected`.
`badRequest (400)`	`operationNotSupported`	طلب البيانات من واجهة برمجة التطبيقات غير صالح أو تم تنسيقه بشكل غير صحيح. وبالتالي، لم يتمكَّن خادم واجهة برمجة التطبيقات من فهم الطلب.
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح.
`forbidden (403)`	`forbidden`	لا يمكن ضبط حالة الإشراف على تعليق واحد أو أكثر بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`notFound (404)`	`commentNotFound`	تعذّر العثور على تعليق واحد أو أكثر من التعليقات التي يحاول الطلب تعديلها. تحقَّق من قيم مَعلمة `id` في الطلب للتأكّد من صحتها.

`comments.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`commentTextRequired`	يجب أن يحدّد مورد `comment` الذي يتم إدراجه قيمة للسمة `snippet.textOriginal`. لا يمكن ترك حقل التعليقات فارغًا.
`badRequest (400)`	`commentTextTooLong`	يحتوي المرجع `comment` الذي يتم إدراجه على عدد كبير جدًا من الأحرف في السمة `snippet.textOriginal`.
`badRequest (400)`	`invalidCommentMetadata`	البيانات الوصفية للطلب غير صالحة.
`badRequest (400)`	`operationNotSupported`	لا يمكن لمستخدم واجهة برمجة التطبيقات إدراج تعليق ردًا على التعليق ذي المستوى الأعلى الذي تحدّده السمة `snippet.parentId`. في مورد `commentThread`، تشير السمة `snippet.canReply` إلى ما إذا كان بإمكان المشاهد الحالي الردّ على سلسلة المحادثات.
`badRequest (400)`	`parentCommentIsPrivate`	التعليق الرئيسي المحدّد خاص. لا تتيح واجهة برمجة التطبيقات الردّ على التعليقات الخاصة.
`badRequest (400)`	`parentIdMissing`	يجب أن يكون التعليق الذي يتم إدراجه مرتبطًا بتعليق رئيسي. ومع ذلك، لم يحدّد مورد `comment` في نص طلب البيانات من واجهة برمجة التطبيقات قيمة للسمة `snippet.parentId`.
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. تحقَّق من بنية المرجع `comment` في نص الطلب للتأكّد من أنّه صالح.
`forbidden (403)`	`forbidden`	لا يمكن إنشاء التعليق بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`forbidden (403)`	`ineligibleAccount`	يجب دمج حساب YouTube المستخدَم لمنح الإذن بطلب البيانات من واجهة برمجة التطبيقات مع حساب المستخدم على Google لإدراج تعليق أو سلسلة تعليقات.
`notFound (404)`	`parentCommentNotFound`	تعذّر العثور على التعليق الرئيسي المحدّد. تحقَّق من قيمة السمة `snippet.parentId` في نص الطلب للتأكّد من صحتها.

`comments.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح.
`forbidden (403)`	`forbidden`	تعذّر حذف التعليق بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`notFound (404)`	`commentNotFound`	تعذّر العثور على التعليق المحدّد. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`comments.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`commentTextTooLong`	يحتوي مورد `comment` الذي يتم تعديله على عدد كبير جدًا من الأحرف في السمة `snippet.textOriginal`.
`badRequest (400)`	`invalidCommentMetadata`	البيانات الوصفية للطلب غير صالحة.
`badRequest (400)`	`operationNotSupported`	طلب البيانات من واجهة برمجة التطبيقات غير صالح أو تم تنسيقه بشكل غير صحيح. وبالتالي، لم يتمكَّن خادم واجهة برمجة التطبيقات من فهم الطلب.
`badRequest (400)`	`processingFailure`	تعذّر على خادم واجهة برمجة التطبيقات معالجة الطلب بنجاح. على الرغم من أنّ هذا الخطأ قد يكون عابرًا، إلا أنّه يشير عادةً إلى أنّ الإدخال في الطلب غير صالح. تحقَّق من بنية المرجع `comment` في نص الطلب للتأكّد من أنّه صالح.
`forbidden (403)`	`forbidden`	تعذّر تعديل التعليق بسبب عدم توفّر أذونات كافية. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`forbidden (403)`	`ineligibleAccount`	يجب دمج حساب YouTube المستخدَم لمنح الإذن بطلب البيانات من واجهة برمجة التطبيقات مع حساب المستخدم على Google لتعديل تعليق أو سلسلة تعليقات.
`notFound (404)`	`commentNotFound`	تعذّر العثور على التعليق المحدّد. تحقَّق من قيمة السمة `id` في نص الطلب للتأكّد من صحتها.

الأعضاء

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد members. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`members.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`channelMembershipsNotEnabled`	لم يتم تفعيل ميزة "العضوية في القنوات" في قناة صانع المحتوى التي تمنح الإذن بالطلب.
`badRequest (400)`	`invalidMode`	قيمة المَعلمة `mode` غير صالحة. قد يحدث هذا الخطأ إذا كانت المَعلمة `pageToken` تحدّد رمزًا مميزًا تم استرداده باستخدام وضع مختلف عن الوضع المحدّد.
`badRequest (400)`	`invalidPageToken`	قيمة المَعلمة `pageToken` غير صالحة. يحدث هذا الخطأ إذا انتهت صلاحية الرمز المميّز للصفحة المستخدَم في الطلب.
`badRequest (400)`	`invalidHasAccessToLevel`	قيمة المَعلمة `hasAccessToLevel` غير صالحة. لا يتوفّر مستوى بالسمة `id` المحدّدة.
`badRequest (400)`	`invalidFilterByMemberChannelId`	قيمة المَعلمة `filterByMemberChannelId` غير صالحة. يحدث هذا الخطأ إذا كانت قيمة المَعلمة `filterByMemberChannelId` تحدّد أكثر من 100 قناة.

membershipsLevels

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد members. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`membershipsLevels.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`channelMembershipsNotEnabled`	لم يفعّل صانع المحتوى الذي يملك القناة ميزة "العضوية في القنوات".

playlistItems

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد playlistItems. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`playlistItems.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`playlistItemsNotAccessible`	لا يتوفّر الإذن المناسب لحذف عنصر قائمة التشغيل المحدّد.
`notFound (404)`	`playlistItemNotFound`	يتعذّر العثور على عنصر قائمة التشغيل الذي تم تحديده باستخدام المَعلمة `id` في الطلب.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية حذف الفيديوهات من قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك حذف فيديو من قائمة تشغيل الفيديوهات التي حمّلتها.

`playlistItems.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`duplicate`	`videoAlreadyInPlaylist`	الفيديو الذي تحاول إضافته إلى قائمة التشغيل موجود فيها من قبل.
`forbidden (403)`	`playlistContainsMaximumNumberOfVideos`	تحتوي قائمة التشغيل على الحد الأقصى المسموح به لعدد الفيديوهات.
`forbidden (403)`	`playlistItemsNotAccessible`	لم يتم تفويض الطلب بشكل صحيح لإدراج عنصر قائمة التشغيل المحدّد.
`invalidValue (400)`	`invalidContentDetails`	السمة `contentDetails` في الطلب غير صالحة. قد يكون السبب هو أنّ الحقل `contentDetails.note` يتضمّن أكثر من 280 حرفًا.
`invalidValue (400)`	`invalidPlaylistItemPosition`	يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقَّق من قيمة السمة `position` في `snippet` الخاص بالمورد.
`invalidValue (400)`	`invalidResourceType`	إنّ قيمة `type` المحدّدة لمعرّف المورد غير متاحة لهذه العملية. يحدّد معرّف المورد العنصر الذي تتم إضافته إلى قائمة التشغيل، مثل `youtube#video`.
`invalidValue (400)`	`manualSortRequired`	يحاول الطلب ضبط موضع عنصر قائمة التشغيل، ولكن قائمة التشغيل لا تستخدم الترتيب اليدوي. (على سبيل المثال، قد يتم ترتيب عناصر قائمة التشغيل حسب التاريخ أو مدى الرواج). يمكنك حلّ الخطأ عن طريق إزالة العنصر `snippet.position` من المورد الذي يدرجه الطلب. إذا أردت أن يكون لعنصر قائمة التشغيل موضع معيّن في القائمة، عليك أولاً تعديل خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. يمكن تعديل هذه الإعدادات في مدير الفيديو في YouTube.
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	الفيديو الذي تحاول إضافته إلى قائمة التشغيل مُدرَج في قائمة تشغيل أخرى لفيديوهات متسلسلة.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية إدراج فيديوهات في قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك إدراج فيديو في قائمة التشغيل "الفيديوهات التي حمّلتها".
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة بالمعلَمة `playlistId` في الطلب.
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تحاول إضافته إلى قائمة التشغيل. تحقَّق من قيمة السمة `videoId` للتأكّد من صحتها.
`required (400)`	`channelIdRequired`	لا يحدّد الطلب قيمة لسمة `channelId` المطلوبة.
`required (400)`	`playlistIdRequired`	لا يحدّد الطلب قيمة لسمة `playlistId` المطلوبة.
`required (400)`	`resourceIdRequired`	يجب أن يحتوي الطلب على مورد يحدّد فيه العنصر `snippet` قيمة `resourceId`.

`playlistItems.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`playlistItemsNotAccessible`	لم يتم تفويض الطلب بشكل صحيح لاسترداد قائمة التشغيل المحدّدة.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة باستخدام المَعلمة `playlistId` في الطلب.
`notFound (404)`	`videoNotFound`	يتعذّر العثور على الفيديو الذي تم تحديده باستخدام المَعلمة `videoId` في الطلب.
`required (400)`	`playlistIdRequired`	لا يحدّد طلب الاشتراك قيمة للسمة `playlistId` المطلوبة.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية إدراج الفيديوهات في قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك إدراج فيديو في قائمة التشغيل "المشاهدة لاحقًا".

`playlistItems.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`playlistItemsNotAccessible`	لم يتم تفويض الطلب بشكل صحيح لتعديل عنصر قائمة التشغيل المحدّد.
`invalidValue (400)`	`invalidPlaylistItemPosition`	يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقَّق من قيمة السمة `position` في `snippet` الخاص بالمورد.
`invalidValue (400)`	`invalidResourceType`	إنّ قيمة `type` المحدّدة لمعرّف المورد غير متاحة لهذه العملية. يحدّد معرّف المرجع العنصر الذي تتم إضافته إلى قائمة التشغيل، مثل `youtube#video`.
`invalidValue (400)`	`invalidSnippet`	لا يحدّد الطلب سمة `snippet` صالحة.
`invalidValue (400)`	`manualSortRequired`	يحاول الطلب ضبط موضع عنصر قائمة التشغيل، ولكن قائمة التشغيل لا تستخدم الترتيب اليدوي. (على سبيل المثال، قد يتم ترتيب عناصر قائمة التشغيل حسب التاريخ أو مدى الرواج). يمكنك معالجة الخطأ عن طريق إزالة العنصر `snippet.position` من المورد الذي يُدرجه الطلب. إذا أردت أن يكون لعنصر قائمة التشغيل موضع معيّن في القائمة، عليك أولاً تعديل خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. يمكن تعديل هذه الإعدادات في مدير الفيديو في YouTube.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية تعديل الفيديوهات في قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك تعديل فيديو في قائمة تشغيل الفيديوهات التي حمّلتها.
`notFound (404)`	`playlistItemNotFound`	يتعذّر العثور على عنصر قائمة التشغيل الذي تم تحديده باستخدام السمة `id` في الطلب.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة بالمعلَمة `playlistId` في الطلب.
`required (400)`	`channelIdRequired`	لا يحدّد الطلب قيمة للسمة `channelId` المطلوبة.
`required (400)`	`playlistIdRequired`	لا يحدّد الطلب قيمة للسمة `playlistId` المطلوبة.
`required (400)`	`playlistItemIdRequired`	يجب أن يستخدم مورد عنصر قائمة التشغيل المحدّد في الطلب السمة `id` لتحديد عنصر قائمة التشغيل الذي يتم تعديله.

قوائم تشغيل

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد playlists. يمكن أن تعرض هذه الطرق أيضًا الأخطاء المُدرَجة في قسم أخطاء الطلبات الشائعة.

`playlists.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`playlistForbidden`	هذه العملية محظورة أو لم يتم تفويض الطلب بشكل صحيح.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة باستخدام المَعلمة `id` في الطلب.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية حذف قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك حذف قائمة تشغيل الفيديوهات التي حمّلتها.

`playlists.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`channelClosed`	تم إغلاق القناة المحدّدة في المَعلمة `channelId`.
`forbidden (403)`	`channelSuspended`	تم تعليق القناة المحدّدة في المَعلمة `channelId`.
`forbidden (403)`	`playlistForbidden`	لا تتوافق قائمة التشغيل المحدّدة باستخدام المَعلمة `id` في الطلب مع الطلب أو لم يتم تفويض الطلب بشكل صحيح.
`notFound (404)`	`channelNotFound`	يتعذّر العثور على القناة المحدّدة في المَعلمة `channelId`.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة بالمعلَمة `id` في الطلب.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات إمكانية عرض قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك إدراج قائمة التشغيل "المشاهدة لاحقًا".

`playlists.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSetError`	يجب ضبط `defaultLanguage` على تحديث `localizations`.
`badRequest (400)`	`localizationValidationError`	تعذّر التحقّق من صحة إحدى القيم في عنصر عمليات الترجمة. استخدِم طريقة playlists.list لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع قوائم التشغيل.
`badRequest (400)`	`maxPlaylistExceeded`	لا يمكن إنشاء قائمة التشغيل لأنّ القناة تحتوي على الحدّ الأقصى المسموح به من قوائم التشغيل.
`forbidden (403)`	`playlistForbidden`	هذه العملية محظورة أو لم يتم تفويض الطلب بشكل صحيح.
`invalidValue (400)`	`invalidPlaylistSnippet`	يوفّر الطلب مقتطفًا غير صالح لقائمة التشغيل.
`required (400)`	`playlistTitleRequired`	يجب أن يحدّد الطلب عنوان قائمة تشغيل.

`playlists.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSetError`	يجب ضبط `defaultLanguage` على تحديث `localizations`.
`badRequest (400)`	`localizationValidationError`	لم يتم التحقّق من صحة إحدى القيم في عنصر الترجمات. استخدِم طريقة playlists.list لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع قوائم التشغيل.
`forbidden (403)`	`playlistForbidden`	هذه العملية محظورة أو لم يتم تفويض الطلب بشكل صحيح.
`invalidValue (400)`	`invalidPlaylistSnippet`	يوفّر الطلب مقتطفًا غير صالح لقائمة التشغيل.
`invalidValue (400)`	`playlistOperationUnsupported`	لا تتيح واجهة برمجة التطبيقات تعديل قائمة التشغيل المحدّدة. على سبيل المثال، لا يمكنك تعديل خصائص قائمة تشغيل الفيديوهات التي حمّلتها.
`notFound (404)`	`playlistNotFound`	يتعذّر العثور على قائمة التشغيل المحدّدة بالمعلَمة `id` في الطلب.
`required (400)`	`playlistTitleRequired`	يجب أن يحدّد الطلب عنوان قائمة التشغيل.

بحث

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد search. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`search.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`invalidChannelId`	تحدّد المَعلمة `channelId` معرّف قناة غير صالح.
`badRequest (400)`	`invalidLocation`	تم تنسيق قيمة المَعلمة `location` و/أو `locationRadius` بشكل غير صحيح.
`badRequest (400)`	`invalidRelevanceLanguage`	تم تنسيق قيمة المَعلمة `relevanceLanguage` بشكل غير صحيح.
`badRequest (400)`	`invalidSearchFilter`	يحتوي الطلب على تركيبة غير صالحة من فلاتر البحث و/أو القيود. يجب ضبط المَعلمة `type` على `video` إذا ضبطت قيمة للمَعلمات `eventType` أو `videoCaption` أو `videoCategoryId` أو `videoDefinition` أو `videoDimension` أو `videoDuration` أو `videoEmbeddable` أو `videoLicense` أو `videoSyndicated` أو `videoType`.

الاشتراكات

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد subscriptions. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`subscriptions.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`subscriptionForbidden`	لم يتم إثبات صحة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة.
`notFound (404)`	`subscriptionNotFound`	يتعذّر العثور على الاشتراك الذي تحاول حذفه. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`subscriptions.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`subscriptionDuplicate`	الاشتراك الذي تحاول إنشاءه متوفّر مسبقًا.
`badRequest (400)`	`subscriptionForbidden`	لقد بلغت الحد الأقصى لعدد الاشتراكات.
`badRequest (400)`	`subscriptionForbidden`	لقد اشتركت مؤخرًا في الكثير من القنوات. يرجى المحاولة مجددًا بعد بضع ساعات.
`badRequest (400)`	`subscriptionForbidden`	لا يمكنك الاشتراك في قناتك.
`forbidden (403)`	`subscriptionForbidden`	لم تتم مصادقة الطلب بشكل صحيح أو أنّه غير متوافق مع هذه القناة.
`notFound (404)`	`publisherNotFound`	تعذّر العثور على المورد المحدّد من خلال السمة `snippet.resourceId` للطلب.
`notFound (404)`	`subscriberNotFound`	يتعذّر العثور على المشترك المحدّد في الطلب.
`required (400)`	`publisherRequired`	يجب أن يستخدم مورد الاشتراك المحدّد في الطلب السمة `snippet.resourceId` لتحديد القناة التي يتم الاشتراك فيها.

`subscriptions.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`accountClosed`	تعذّر استرداد الاشتراكات لأنّ حساب المشترك مغلق.
`forbidden (403)`	`accountSuspended`	تعذّر استرداد الاشتراكات لأنّ حساب المشترك معلّق.
`forbidden (403)`	`subscriptionForbidden`	لا يُسمح لمقدِّم الطلب بالوصول إلى الاشتراكات المطلوبة.
`notFound (404)`	`subscriberNotFound`	يتعذّر العثور على المشترك المحدّد في الطلب.

الصور المصغّرة

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد thumbnails. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`thumbnails.set`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`invalidImage`	محتوى الصورة المقدَّم غير صالح.
`badRequest (400)`	`mediaBodyRequired`	لا يتضمّن الطلب محتوى الصورة.
`forbidden (403)`	`forbidden`	لا يمكن ضبط الصورة المصغّرة للفيديو المحدّد. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`forbidden (403)`	`forbidden`	لا يملك المستخدم الذي تمت مصادقته أذونات لتحميل الصور المصغّرة المخصّصة للفيديوهات وضبطها.
`notFound (404)`	`videoNotFound`	يتعذّر العثور على الفيديو الذي تحاول إدراج صورة مصغّرة له. تحقَّق من قيمة مَعلمة `videoId` في الطلب للتأكّد من صحتها.
`tooManyRequests (429)`	`uploadRateLimitExceeded`	حمّلت القناة عددًا كبيرًا جدًا من الصور المصغّرة مؤخرًا. يُرجى إعادة المحاولة لاحقًا.

videoAbuseReportReasons

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد videoAbuseReportReasons. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`videoAbuseReportReasons.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	الوصول إلى هذه الصفحة محظور. قد لا يكون الطلب مصرّحًا به بشكل صحيح.

videoCategories

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد videoCategories. قد تعرض هذه الطرق أيضًا الأخطاء المدرَجة في قسم أخطاء الطلبات الشائعة.

`videoCategories.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`notFound (404)`	`videoCategoryNotFound`	يتعذّر العثور على فئة الفيديو المحدّدة من خلال المَعلمة `id`. استخدِم طريقة videoCategories.list لاسترداد قائمة بالقيم الصالحة.

فيديوهات

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد videos. يمكن أن تعرض هذه الطرق أيضًا الأخطاء المُدرَجة في قسم أخطاء الطلبات الشائعة.

`videos.insert`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSet`	يحاول الطلب إضافة تفاصيل فيديو معدَّلة بما يناسب السوق المحلية بدون تحديد اللغة التلقائية لتفاصيل الفيديو.
`badRequest (400)`	`invalidCategoryId`	تحدّد السمة `snippet.categoryId` معرّف فئة غير صالح. استخدِم طريقة `videoCategories.list` لاسترداد الفئات المتوافقة.
`badRequest (400)`	`invalidDescription`	تحدّد البيانات الوصفية للطلب وصفًا غير صالح للفيديو.
`badRequest (400)`	`invalidFilename`	اسم ملف الفيديو المحدّد في العنوان `Slug` غير صالح.
`badRequest (400)`	`invalidPublishAt`	تحدّد البيانات الوصفية للطلب وقت نشر مجدوَل غير صالح.
`badRequest (400)`	`invalidRecordingDetails`	يحدّد العنصر `recordingDetails` في البيانات الوصفية للطلب تفاصيل تسجيل غير صالحة.
`badRequest (400)`	`invalidTags`	تحدّد البيانات الوصفية للطلب كلمات رئيسية غير صالحة للفيديو.
`badRequest (400)`	`invalidTitle`	تحدّد البيانات الوصفية للطلب عنوان فيديو غير صالح أو فارغ.
`badRequest (400)`	`invalidVideoGameRating`	تحدّد البيانات الوصفية للطلب تقييمًا غير صالح للعبة الفيديو.
`badRequest (400)`	`invalidVideoMetadata`	بيانات الطلب الوصفية غير صالحة. يحدث هذا الخطأ إذا كان الطلب يعدّل الجزء `snippet` من مورد `video` ولكن لا يضبط قيمة لكل من السمتَين `snippet.title` و`snippet.categoryId`.
`badRequest (400)`	`mediaBodyRequired`	لا يتضمّن الطلب محتوى الفيديو.
`badRequest (400)`	`uploadLimitExceeded`	تم بلوغ الحدّ الأقصى اليومي لعدد الفيديوهات التي يمكن تحميلها على القناة. هذا قيد تفرضه منصة YouTube وهو منفصل تمامًا عن حصة واجهة برمجة التطبيقات في مشروعك على Google Cloud.
`forbidden (403)`	`forbidden`
`forbidden (403)`	`forbiddenLicenseSetting`	يحاول الطلب ضبط ترخيص غير صالح للفيديو.
`forbidden (403)`	`forbiddenPrivacySetting`	يحاول الطلب ضبط إعداد خصوصية غير صالح للفيديو.

`videos.list`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`videoChartNotFound`	قائمة الفيديوهات الرائجة المطلوبة غير متاحة أو غير متوافقة.
`forbidden (403)`	`forbidden`	لم يتم تفويض الطلب بشكل صحيح للوصول إلى ملف الفيديو أو معلومات المعالجة. تتوفّر الأجزاء `fileDetails` و`processingDetails` و`suggestions` لمالك الفيديو فقط.
`forbidden (403)`	`forbidden`	لا يمكن للطلب الوصول إلى معلومات تقييم المستخدم. قد يحدث هذا الخطأ لأنّ الطلب غير مصرَّح له بشكل صحيح باستخدام المَعلمة `myRating`.
`notFound (404)`	`videoNotFound`	يتعذّر العثور على الفيديو الذي تحاول استرداده. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`videos.delete`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	لا يمكن حذف الفيديو الذي تحاول حذفه. قد لا يكون الطلب مُصرّحًا به بشكلٍ صحيح.
`notFound (404)`	`videoNotFound`	يتعذّر العثور على الفيديو الذي تحاول حذفه. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`videos.update`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`defaultLanguageNotSet`	يحاول طلب البيانات من واجهة برمجة التطبيقات إضافة تفاصيل فيديو معدَّلة بما يناسب السوق المحلية بدون تحديد اللغة التلقائية لتفاصيل الفيديو.
`badRequest (400)`	`invalidCategoryId`	تحدّد السمة `snippet.categoryId` معرّف فئة غير صالح. استخدِم طريقة `videoCategories.list` لاسترداد الفئات المتوافقة.
`badRequest (400)`	`invalidDefaultBroadcastPrivacySetting`	يحاول الطلب ضبط إعداد خصوصية غير صالح للبث التلقائي.
`badRequest (400)`	`invalidDescription`	تحدّد البيانات الوصفية للطلب وصفًا غير صالح للفيديو.
`badRequest (400)`	`invalidPublishAt`	تحدّد البيانات الوصفية للطلب وقت نشر مجدوَل غير صالح.
`badRequest (400)`	`invalidRecordingDetails`	يحدّد العنصر `recordingDetails` في البيانات الوصفية للطلب تفاصيل تسجيل غير صالحة.
`badRequest (400)`	`invalidTags`	تحدّد البيانات الوصفية للطلب كلمات رئيسية غير صالحة للفيديو.
`badRequest (400)`	`invalidTitle`	تحدّد البيانات الوصفية للطلب عنوان فيديو غير صالح أو فارغًا.
`badRequest (400)`	`invalidVideoMetadata`	بيانات الطلب الوصفية غير صالحة. يحدث هذا الخطأ إذا كان الطلب يحدّث الجزء `snippet` من مورد `video` ولكنّه لا يضبط قيمة لكلّ من السمتَين `snippet.title` و`snippet.categoryId`.
`forbidden (403)`	`forbidden`	الوصول إلى هذه الصفحة محظور. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`forbidden (403)`	`forbiddenEmbedSetting`	يحاول الطلب ضبط إعداد تضمين غير صالح للفيديو. قد لا تملك بعض القنوات الإذن بتوفير مشغّلات مضمّنة لأحداث البث المباشر. لمزيد من المعلومات، يُرجى الانتقال إلى مركز مساعدة YouTube.
`forbidden (403)`	`forbiddenLicenseSetting`	يحاول الطلب ضبط ترخيص غير صالح للفيديو.
`forbidden (403)`	`forbiddenPrivacySetting`	يحاول الطلب ضبط إعداد خصوصية غير صالح للفيديو.
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تحاول تعديله. تحقَّق من قيمة حقل `id` في نص الطلب للتأكّد من صحتها.

`videos.rate`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`emailNotVerified`	يجب أن يثبت المستخدم ملكية عنوان بريده الإلكتروني قبل التقييم.
`badRequest (400)`	`invalidRating`	تضمّن الطلب قيمة غير متوقّعة للمَعلمة `rating`.
`badRequest (400)`	`videoPurchaseRequired`	لا يمكن تقييم الفيديوهات المتاحة للاستئجار إلا من قِبل المستخدمين الذين استأجروها.
`forbidden (403)`	`forbidden`	لا يمكن تقييم الفيديو الذي تحاول تقييمه. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
`forbidden (403)`	`videoRatingDisabled`	أوقف مالك الفيديو الذي تحاول تقييمه ميزة التقييمات لهذا الفيديو.
`notFound (404)`	`videoNotFound`	يتعذّر العثور على الفيديو الذي تحاول تقييمه. تحقَّق من قيمة المَعلمة `id` للطلب للتأكّد من صحتها.

`videos.reportAbuse`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`invalidAbuseReason`	تضمّن الطلب قيمة غير متوقّعة للحقل `reason_id` أو لمزيج من الحقلَين `reason_id` و`secondary_reason_id`.
`badRequest (400)`	`rateLimitExceeded`	أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني معيّن.
`forbidden (403)`	`forbidden`
`notFound (404)`	`videoNotFound`	تعذّر العثور على الفيديو الذي تحاول الإبلاغ عنه بسبب إساءة الاستخدام.

العلامات المائية

تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات المرتبطة بموارد watermarks. يمكن أن تعرض هذه الطرق أيضًا الأخطاء المُدرَجة في قسم أخطاء الطلبات الشائعة.

`watermarks.set`

نوع الخطأ	تفاصيل الخطأ	الوصف
`badRequest (400)`	`imageFormatUnsupported`	تنسيق الصورة التي قدّمتها غير متوافق.
`badRequest (400)`	`imageTooTall`	الصورة التي قدّمتها طويلة جدًا.
`badRequest (400)`	`imageTooWide`	الصورة التي قدّمتها عريضة جدًا.
`badRequest (400)`	`mediaBodyRequired`	لا يتضمّن الطلب محتوى الصورة.
`forbidden (403)`	`forbidden`	لا يمكن ضبط العلامة المائية للقناة المحدّدة. قد لا يكون الطلب معتمَدًا بشكل صحيح، أو قد تكون المَعلمة `channelId` مضبوطة على قيمة غير صالحة.

`watermarks.unset`

نوع الخطأ	تفاصيل الخطأ	الوصف
`forbidden (403)`	`forbidden`	لا يمكن إلغاء ضبط العلامة المائية للقناة المحدّدة. قد لا يكون الطلب مصرَّحًا به بشكل صحيح، أو تم ضبط المَعلمة `channelId` على قيمة غير صالحة.

YouTube Data API - Errors تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأخطاء العامة

Core API errors

Common request errors

Request context errors

الأنشطة

activities.list

مقاطع الترجمة والشرح

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

قنوات

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

comments

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update