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 لا يملك مستخدم نظام "إدارة المحتوى" إمكانات كافية.
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 لاسترداد القيم الصالحة وتعديلها وفقًا للإرشادات الواردة في مستندات مرجع 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.
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 لم يتم العثور على معرّف القناة 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 يجب أن يحدّد الطلب عنوان قائمة تشغيل.

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

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