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 لا يُسمح لمستخدم "نظام إدارة المحتوى" (CMS) بالتصرف نيابةً عن مالك المحتوى المحدَّد.
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 ولكن ربما لم يسبق له ربط حساب Google هذا بقناة على YouTube.

يظهر هذا الخطأ عادةً إذا حاولت استخدام مسار حساب خدمة OAuth 2.0. لا تتيح YouTube استخدام حسابات الخدمة، وإذا حاولت المصادقة باستخدام حساب الخدمة، ستظهر رسالة الخطأ هذه.

تتناول مشاركة المدونة الخاصة بواجهة برمجة تطبيقات YouTube التي تضم دعم حساب Google أيضًا خطأ youtubeSignupRequired بمزيد من التفصيل. على الرغم من أنّ مشاركة المدونة تشرح الخطأ في الإصدار 2.1 من واجهة برمجة التطبيقات، لا يزال معنى الخطأ ساريًا.

الأنشطة

أوقفت منصة YouTube ميزة نشرة القناة نهائيًا. لم تعُد طريقة activities.insert متاحة.

تحدِّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للمكالمات المتعلّقة بمورد 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.

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.insert

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

أقسام القناة

تحدِّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للمكالمات المتعلّقة بمورد 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 لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable لا يمكن إنشاء قسم القناة هذا.
badRequest (400) styleRequired يجب أن يحدّد مورد channelSection قيمة للحقل snippet.style.
badRequest (400) targetInvalidCountry تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.countries. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.languages. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.regions. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">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 لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable لا يمكن تعديل قسم القناة هذا.
badRequest (400) styleRequired يجب أن يحدّد مورد channelSection قيمة للحقل snippet.style.
badRequest (400) targetInvalidCountry تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.countries. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.languages. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion تعذَّر التحقُّق من صحة إحدى القيم الموجودة في قائمة targeting.regions. استخدِم الإجراء channelsections.list لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مراجع a href="/youtube/v3/docs/channelSections#resource">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. استخدِم الإجراء guideCategories.list لاسترداد قائمة بالقيم الصالحة.
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 لاسترداد القيم الصالحة، واحرص على تعديلها باتّباع الإرشادات الواردة في مستندات المراجع الخاصة بالقنوات.
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 لم يتم العثور على معرّف القناة المحدّد مؤخرًاالذي تم تحميله من قبل.
notFound (404) unknownVideoId لا يمكن العثور على معرّف الفيديو المحدّد كعنصر تم الترويج له.
required (400) requiredItemIdType يجب أن تحدد البيانات الوصفية للطلب نوع عنصر في جزء invideopromo.
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.list

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

commentThreads.insert

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) channelOrVideoIdMissing يجب أن تكون سلسلة التعليقات مرتبطة بقناة أو فيديو.
  • إذا كان التعليق ينطبق على قناة، تأكَّد من أنّ المورد المحدّد في نص الطلب يقدّم قيمة للسمة snippet.channelId. ويظهر تعليق ينطبق على قناة في علامة التبويب مناقشة في القناة.
  • إذا كان التعليق ينطبق على فيديو، تأكَّد من أنّ المورد يحدّد قيمًا لكلٍ من السمتَين 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.markAsSpam متاحة.

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

comments.list

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

comments.setModerationStatus

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) banWithoutReject لا يمكن استخدام المَعلمة banAuthor إلا إذا كانت قيمة المَعلمة moderationStatus هي rejected.
badRequest (400) operationNotSupported لا تقدم التعليقات المستندة إلى +Google سوى وظائف الإشراف المحدودة.
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 يمكن تعديل التعليقات المستندة إلى +Google فقط.
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 قناة.

مستويات الاشتراكات

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

membershipsLevels.list

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) channelMembershipsNotEnabled إنّ ميزة "الاشتراكات الداعمة للقناة" غير مفعّلة على قناة صانع المحتوى التي تسمح للطلب.

عناصر قائمة التشغيل

تحدِّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للمكالمات المتعلّقة بمورد 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 يجب أن يحدّد الطلب عنوان قائمة تشغيل.

عدد الاشتراكات:

تحدِّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للمكالمات المتعلّقة بمورد 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.list

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) forbidden الدخول محظور. قد لا يكون الطلب مفوَّضًا بشكل صحيح.

فئات الفيديو

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

videoCategories.list

نوع الخطأ تفاصيل الخطأ الوصف
notFound (404) videoCategoryNotFound لا يمكن العثور على فئة الفيديو التي تم تحديدها من خلال المَعلمة id. استخدِم الإجراء videoCategory.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 تجاوز المستخدم عدد الفيديوهات التي يمكن تحميلها.
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 على قيمة غير صالحة.