يحدد هذا المستند الأنواع المختلفة من الأخطاء التي يمكن أن تعرضها عمليات YouTube Data API. يمكنك أيضًا العثور على قائمة بالأخطاء لأي طريقة فردية في المستندات المرجعية الخاصة بتلك الطريقة.
الأخطاء العامة
تحدد الجداول التالية رسائل خطأ واجهة برمجة التطبيقات التي لا تتعلق بطريقة معينة في واجهة برمجة التطبيقات.
Core API errors
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
forbidden |
الدخول محظور. قد لا يكون الطلب مفوَّضًا بشكل صحيح. |
quotaExceeded (403) |
quotaExceeded |
يتعذّر إكمال الطلب لأنّك تجاوزت الحصة المخصّصة لك. |
Common request errors
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
incompatibleParameters |
يحدِّد الطلب مَعلمتَين أو أكثر لا يمكن استخدامهما في الطلب نفسه. |
badRequest (400) |
invalidFilters |
يحدِّد الطلب مَعلمة فلتر غير صالحة. |
badRequest (400) |
invalidPageToken |
يحدد الطلب رمزًا مميزًا للصفحة غير صالح. |
badRequest (400) |
missingRequiredParameter |
يفتقد الطلب معلَمة مطلوبة. |
badRequest (400) |
unexpectedParameter |
يحدِّد الطلب مَعلمة غير متوقّعة. |
forbidden (403) |
accountDelegationForbidden |
لا يمكن للمستخدم الذي تمت المصادقة عليه التصرف نيابةً عن حساب Google المحدّد. |
forbidden (403) |
authenticatedUserAccountClosed |
تم إغلاق حساب YouTube للمستخدم الذي تمت المصادقة عليه. إذا كان المستخدم الذي تمت مصادقته يتصرّف نيابةً عن حساب Google آخر، يشير هذا الخطأ إلى هذا الخطأ. |
forbidden (403) |
authenticatedUserAccountSuspended |
تم تعليق حساب YouTube للمستخدم الذي تمت المصادقة عليه. إذا كان المستخدم الذي تمت مصادقته يتصرّف نيابةً عن حساب Google آخر، يشير هذا الخطأ إلى هذا الخطأ. |
forbidden (403) |
authenticatedUserNotChannel |
بالنسبة إلى هذا الطلب، على المستخدم الذي تمت مصادقته تحويله إلى قناة، ولكن لا يمكنه ذلك. إذا تمت مصادقة طلبك واستخدم معلَمة التفويض onBehalfOfContentOwner ، عليك أيضًا ضبط المعلَمة onBehalfOfContentOwnerChannel . |
forbidden (403) |
channelClosed |
تم إغلاق القناة المحدّدة في الطلب. |
forbidden (403) |
channelNotFound |
تعذّر العثور على القناة المحدّدة في الطلب. |
forbidden (403) |
channelSuspended |
تم تعليق القناة المحدّدة في الطلب. |
forbidden (403) |
cmsUserAccountNotFound |
غير مسموح لمستخدم نظام إدارة المحتوى بالتصرف نيابةً عن مالك المحتوى المحدّد. |
forbidden (403) |
insufficientCapabilities |
لا تتوفّر لدى مستخدم نظام إدارة المحتوى (CMS) إمكانيات كافية. |
forbidden (403) |
insufficientPermissions |
يحدِّد رمز OAuth 2.0 المميز المقدَّم للطلب النطاقات غير الكافية للوصول إلى البيانات المطلوبة. |
notFound (404) |
contentOwnerAccountNotFound |
لم يتم العثور على حساب مالك المحتوى المحدد. |
Request context errors
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
invalidLanguage |
لا تحدّد قيمة المعلَمة hl رمز لغة صالحًا. |
badRequest (400) |
invalidMine |
استخدام الطلب للمَعلمة mine غير متاح. |
badRequest (400) |
invalidMine |
لا يمكن استخدام المعلَمة mine في الطلبات التي يكون فيها المستخدم الذي تمت مصادقته أحد شركاء YouTube. يجب إزالة المعلَمة mine ، أو المصادقة بصفتك مستخدمًا لمنصة YouTube من خلال إزالة المعلَمة onBehalfOfContentOwner ، أو العمل كإحدى قنوات الشريك من خلال توفير المَعلمة onBehalfOfContentOwnerChannel إذا كانت متاحة للطريقة التي يتم طلبها. |
badRequest (400) |
invalidPart |
تحدّد معلَمة part الخاصة بالطلب بعض الأجزاء التي لا يمكن كتابتها في الوقت نفسه. |
badRequest (400) |
invalidRegionCode |
تحدّد المعلَمة regionCode رمز منطقة غير صالح. |
badRequest (400) |
unexpectedPart |
تحدّد معلَمة part للطلب قيمة غير متوقعة. |
badRequest (400) |
unknownPart |
تحدّد معلَمة part للطلب قيمة غير معروفة. |
badRequest (400) |
unsupportedLanguageCode |
لا تحدّد قيمة المعلَمة hl رمز لغة متوافقًا. |
badRequest (400) |
unsupportedRegionCode |
تحدّد المعلَمة regionCode رمز منطقة غير متوافق. |
unauthorized (401) |
authorizationRequired |
يستخدم الطلب المعلَمة mine ولكن لم يتم تفويضه بشكل صحيح. |
unauthorized (401) |
youtubeSignupRequired |
يشير هذا الخطأ إلى أنّ المستخدم لديه حساب Google غير مرتبط، ما يعني أنّ المستخدم لديه حساب على Google ولكنّه لا يملك قناة على YouTube. يمكن لهؤلاء المستخدمين الوصول إلى العديد من الميزات التي تعتمد على أذونات المستخدم، مثل تقييم الفيديوهات أو إضافة فيديوهات إلى قائمة تشغيل watch_later . ومع ذلك، على سبيل المثال، سيحتاج المستخدم إلى قناة على YouTube ليتمكن من تحميل الفيديو. من المؤكّد أنّ المستخدم الذي لديه حساب Gmail أو جهاز Android لديه حساب على Google، ولكنه قد لا يكون قد ربط حساب Google بقناة على YouTube.يظهر هذا الخطأ بشكل شائع إذا كنت تحاول استخدام مسار حساب خدمة OAuth 2.0. لا تتيح YouTube استخدام حسابات الخدمة، وإذا حاولت المصادقة باستخدام حساب الخدمة، سيظهر هذا الخطأ. تتناول مشاركة مدوّنة واجهة برمجة تطبيقات YouTube التي تقدّم الدعم بشأن حساب Google خطأ youtubeSignupRequired بمزيد من التفصيل. على الرغم من أنّ مشاركة المدونة تشرح الخطأ الخاص بالإصدار 2.1 من واجهة برمجة التطبيقات، إلا أنّ معنى الخطأ لا يزال ساريًا. |
الأنشطة
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 . |
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="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
لا يمكن إنشاء قسم من القناة. |
badRequest (400) |
styleRequired |
يجب أن يحدّد مورد channelSection قيمة للحقل snippet.style . |
badRequest (400) |
targetInvalidCountry |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.countries ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.languages ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.regions ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/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="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
لا يمكن تعديل قسم القناة هذا. |
badRequest (400) |
styleRequired |
يجب أن يحدّد مورد channelSection قيمة للحقل snippet.style . |
badRequest (400) |
targetInvalidCountry |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.countries ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.languages ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
تعذّر التحقّق من إحدى القيم في قائمة "targeting.regions ". استخدِم الإجراء channelSections.list لاسترداد القيم الصالحة وتعديلها باتّباع الإرشادات الواردة في مستندات مراجع a href="/https/developers.google.com/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 |
لم يتم العثور على معرّف القناة المحدد مؤخرًاUploadedBy. |
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 للتأكّد من صحتها. |
الأعضاء
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد members
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
members.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
إنّ قناة صانع المحتوى التي تسمح بالطلب غير مفعّلة في ميزة "العضوية في القنوات". |
badRequest (400) |
invalidMode |
قيمة المعلَمة mode غير صالحة.
قد يحدث هذا الخطأ إذا كانت المَعلمة pageToken
تحدّد رمزًا مميّزًا تم استرداده باستخدام وضع مختلف عن الوضع المحدّد. |
badRequest (400) |
invalidPageToken |
قيمة المعلَمة pageToken غير صالحة. يحدث هذا الخطأ إذا انتهت صلاحية الرمز المميّز للصفحة المستخدَم في الطلب. |
badRequest (400) |
invalidHasAccessToLevel |
قيمة المعلَمة hasAccessToLevel غير صالحة. ما مِن مستوى يتضمّن السمة id المحدّدة. |
badRequest (400) |
invalidFilterByMemberChannelId |
قيمة المعلَمة filterByMemberChannelId غير صالحة. يحدث هذا الخطأ إذا كانت قيمة
المعلَمة filterByMemberChannelId
تحدّد أكثر من 100 قناة. |
membershipsLevels
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد members
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
membershipsLevels.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
إنّ قناة صانع المحتوى التي تسمح بالطلب غير مفعّلة في ميزة "العضوية في القنوات". |
playlistItems
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد playlistItems
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
playlistItems.delete
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرح له بحذف عنصر قائمة التشغيل المحدد بشكل صحيح. |
notFound (404) |
playlistItemNotFound |
يتعذّر العثور على عنصر قائمة التشغيل المحدّد باستخدام مَعلمة id الخاصة بالطلب. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية حذف الفيديوهات من قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك حذف فيديو من قائمة تشغيل الفيديوهات التي حمّلتها. |
playlistItems.insert
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
duplicate |
videoAlreadyInPlaylist |
الفيديو الذي تحاول إضافته إلى قائمة التشغيل موجود مسبقًا في قائمة التشغيل. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
تحتوي قائمة التشغيل حاليًا على الحد الأقصى المسموح به لعدد العناصر. |
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مسموح له بإدراج عنصر قائمة التشغيل المحدد بشكل صحيح. |
invalidValue (400) |
invalidContentDetails |
السمة contentDetails في الطلب غير صالحة. أحد الأسباب المحتملة لذلك هو أنّ الحقل contentDetails.note أطول من 280 حرفًا. |
invalidValue (400) |
invalidPlaylistItemPosition |
يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقّق من قيمة السمة position في snippet للمصدر. |
invalidValue (400) |
invalidResourceType |
لا يمكن تنفيذ هذه العملية على type المحدّد لرقم تعريف المورد. يحدد رقم تعريف المورد العنصر الذي تتم إضافته إلى قائمة التشغيل، مثل youtube#video . |
invalidValue (400) |
manualSortRequired |
يحاول الطلب تعيين موضع عنصر قائمة التشغيل، إلا أنّ قائمة التشغيل لا تستخدم الترتيب اليدوي. (على سبيل المثال، يمكن ترتيب عناصر قوائم التشغيل حسب التاريخ أو مدى الرواج). يمكنك معالجة الخطأ عن طريق إزالة العنصر snippet.position من المورد الذي يدرجه الطلب. إذا أردت أن يكون لعنصر قائمة التشغيل موضعًا معينًا في القائمة، يجب أولاً تغيير خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. ويمكنك تعديل هذه الإعدادات في مدير الفيديو في YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
إنّ الفيديو الذي تحاول إضافته إلى قائمة التشغيل مُدرَج في قائمة تشغيل متسلسلة أخرى. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية إدراج فيديوهات في قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك إدراج فيديو في قائمة تشغيل الفيديوهات التي حمّلتها. |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة playlistId الخاصة بالطلب. |
notFound (404) |
videoNotFound |
يتعذر العثور على الفيديو الذي تحاول إضافته إلى قائمة التشغيل. تحقّق من قيمة السمة videoId للتأكّد من صحتها. |
required (400) |
channelIdRequired |
لا يحدِّد الطلب قيمة للسمة channelId المطلوبة. |
required (400) |
playlistIdRequired |
لا يحدِّد الطلب قيمة للسمة playlistId المطلوبة. |
required (400) |
resourceIdRequired |
يجب أن يحتوي الطلب على مورد يُحدِّد فيه الكائن snippet عنصر resourceId . |
playlistItems.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرح به بشكل صحيح لاسترداد قائمة التشغيل المحددة. |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة playlistId الخاصة بالطلب. |
notFound (404) |
videoNotFound |
يتعذّر العثور على الفيديو الذي تم تحديده باستخدام معلَمة videoId الخاصة بالطلب. |
required (400) |
playlistIdRequired |
لا يحدِّد طلب الاشتراك قيمة للسمة playlistId المطلوبة. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية إدراج الفيديوهات في قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك إدراج فيديو في قائمة التشغيل "المشاهدة لاحقًا". |
playlistItems.update
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرح به بشكل صحيح لتحديث عنصر قائمة التشغيل المحدد. |
invalidValue (400) |
invalidPlaylistItemPosition |
يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقّق من قيمة السمة position في snippet للمصدر. |
invalidValue (400) |
invalidResourceType |
لا يمكن تنفيذ هذه العملية على type المحدّد لرقم تعريف المورد. يحدد رقم تعريف المورد العنصر الذي تتم إضافته إلى قائمة التشغيل، مثل youtube#video . |
invalidValue (400) |
invalidSnippet |
لا يحدّد الطلب سمة snippet صالحة. |
invalidValue (400) |
manualSortRequired |
يحاول الطلب تعيين موضع عنصر قائمة التشغيل، إلا أنّ قائمة التشغيل لا تستخدم الترتيب اليدوي. (على سبيل المثال، يمكن ترتيب عناصر قوائم التشغيل حسب التاريخ أو مدى الرواج). يمكنك معالجة الخطأ عن طريق إزالة العنصر snippet.position من المورد الذي يدرجه الطلب. إذا أردت أن يكون لعنصر قائمة التشغيل موضعًا معينًا في القائمة، يجب أولاً تغيير خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. ويمكنك تعديل هذه الإعدادات في مدير الفيديو في YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية تحديث الفيديوهات في قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك تعديل فيديو في قائمة التشغيل التي حمّلتها. |
notFound (404) |
playlistItemNotFound |
يتعذّر العثور على عنصر قائمة التشغيل المحدّد باستخدام السمة id الخاصة بالطلب. |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة playlistId الخاصة بالطلب. |
required (400) |
channelIdRequired |
لا يحدِّد الطلب قيمة للسمة channelId المطلوبة. |
required (400) |
playlistIdRequired |
لا يحدِّد الطلب قيمة للسمة playlistId المطلوبة. |
required (400) |
playlistItemIdRequired |
يجب أن يستخدم مورد عنصر قائمة التشغيل المحدّد في الطلب السمة id لتحديد عنصر قائمة التشغيل الذي يتم تعديله. |
قوائم تشغيل
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد playlists
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
playlists.delete
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
playlistForbidden |
يحظر إجراء هذه العملية أو أن هذا الطلب غير مصرح به. |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة id الخاصة بالطلب. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية حذف قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك حذف قائمة تشغيل الفيديوهات التي حمّلتها. |
playlists.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
channelClosed |
تم إغلاق القناة المحدّدة في المَعلمة channelId . |
forbidden (403) |
channelSuspended |
تم تعليق القناة المحدّدة في المَعلمة channelId . |
forbidden (403) |
playlistForbidden |
إنّ قائمة التشغيل المحدَّدة بالمَعلمة id الخاصة بالطلب لا تتوافق مع الطلب أو أنّ الطلب غير مصرَّح به. |
notFound (404) |
channelNotFound |
يتعذّر العثور على القناة المحدّدة في المَعلمة channelId . |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة id الخاصة بالطلب. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية إدراج قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك إدراج قائمة التشغيل "المشاهدة لاحقًا". |
playlists.insert
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
يجب ضبط defaultLanguage لتحديث localizations . |
badRequest (400) |
localizationValidationError |
تعذَّر التحقق من صحة إحدى القيم في كائن عمليات الأقلمة. استخدِم طريقة playlists.list لاسترداد القيم الصالحة والتأكّد من تعديلها باتّباع الإرشادات الواردة في مستندات المراجع الخاصة بقوائم التشغيل. |
badRequest (400) |
maxPlaylistExceeded |
لا يمكن إنشاء قائمة التشغيل لأنّ القناة تضمّ حاليًا الحدّ الأقصى لعدد قوائم التشغيل المسموح بها. |
forbidden (403) |
playlistForbidden |
يحظر إجراء هذه العملية أو أن هذا الطلب غير مصرح به. |
invalidValue (400) |
invalidPlaylistSnippet |
يتضمن الطلب مقتطف قائمة تشغيل غير صالح. |
required (400) |
playlistTitleRequired |
يجب أن يحدّد الطلب عنوان قائمة تشغيل. |
playlists.update
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
يجب ضبط defaultLanguage لتحديث localizations . |
badRequest (400) |
localizationValidationError |
تعذَّر التحقق من صحة إحدى القيم في كائن عمليات الأقلمة. استخدِم طريقة playlists.list لاسترداد القيم الصالحة والتأكّد من تعديلها باتّباع الإرشادات الواردة في مستندات المراجع الخاصة بقوائم التشغيل. |
forbidden (403) |
playlistForbidden |
يحظر إجراء هذه العملية أو أن هذا الطلب غير مصرح به. |
invalidValue (400) |
invalidPlaylistSnippet |
يتضمن الطلب مقتطف قائمة تشغيل غير صالح. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية تحديث قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك تعديل خصائص قائمة تشغيل الفيديوهات التي حمّلتها. |
notFound (404) |
playlistNotFound |
يتعذّر العثور على قائمة التشغيل المحدَّدة بالمَعلمة id الخاصة بالطلب. |
required (400) |
playlistTitleRequired |
يجب أن يحدّد الطلب عنوان قائمة تشغيل. |
search
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد search
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
search.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
invalidChannelId |
حدّدت المعلمة channelId معرّف قناة غير صالح. |
badRequest (400) |
invalidLocation |
تم تنسيق قيمة المعلَمة location و/أو locationRadius بشكلٍ غير صحيح. |
badRequest (400) |
invalidRelevanceLanguage |
تم تنسيق قيمة المعلَمة relevanceLanguage بشكلٍ غير صحيح. |
badRequest (400) |
invalidSearchFilter |
يحتوي الطلب على تركيبة غير صالحة من فلاتر البحث و/أو القيود. يجب ضبط المَعلمة type على video في حال ضبط قيمة للمَعلمات eventType أو videoCaption أو videoCategoryId أو videoDefinition أو videoDimension أو videoDuration أو videoEmbeddable أو videoLicense أو videoSyndicated أو videoType . |
عدد الاشتراكات:
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد subscriptions
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
subscriptions.delete
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
subscriptionForbidden |
لم تتم مصادقة الطلب بشكل صحيح أو أنه غير معتمد لهذه القناة. |
notFound (404) |
subscriptionNotFound |
يتعذّر العثور على الاشتراك الذي تحاول حذفه. تحقّق من قيمة معلَمة id للطلب للتأكّد من صحتها. |
subscriptions.insert
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
الاشتراك الذي تحاول إنشاءه موجود من قبل. |
badRequest (400) |
subscriptionForbidden |
لقد وصلت إلى الحد الأقصى لعدد الاشتراكات. |
badRequest (400) |
subscriptionForbidden |
هناك عدد كبير جدًا من الاشتراكات الحديثة. يُرجى المحاولة مرة أخرى بعد بضع ساعات. |
badRequest (400) |
subscriptionForbidden |
لا يمكن الاشتراك في قناتك. |
forbidden (403) |
subscriptionForbidden |
لم تتم مصادقة الطلب بشكل صحيح أو أنه غير معتمد لهذه القناة. |
notFound (404) |
publisherNotFound |
يتعذّر العثور على المورد المحدّد في سمة snippet.resourceId الخاصة بالطلب. |
notFound (404) |
subscriberNotFound |
يتعذّر العثور على المشترك المحدّد بالطلب. |
required (400) |
publisherRequired |
يجب أن يستخدم مورد الاشتراك المحدّد في الطلب السمة snippet.resourceId لتحديد القناة التي تريد الاشتراك فيها. |
subscriptions.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
accountClosed |
تعذّر استرداد الاشتراكات بسبب إغلاق حساب المشترك. |
forbidden (403) |
accountSuspended |
تعذّر استرداد الاشتراكات بسبب تعليق حساب المشترك. |
forbidden (403) |
subscriptionForbidden |
غير مسموح لمقدِّم الطلب بالوصول إلى الاشتراكات المطلوبة. |
notFound (404) |
subscriberNotFound |
يتعذّر العثور على المشترك المحدّد بالطلب. |
الصور المصغّرة
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد thumbnails
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
thumbnails.set
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
invalidImage |
محتوى الصورة التي تم تقديمها غير صالح. |
badRequest (400) |
mediaBodyRequired |
لا يتضمّن الطلب محتوى الصورة. |
forbidden (403) |
forbidden |
يتعذّر ضبط الصورة المصغّرة للفيديو المحدَّد. قد يكون الطلب غير مفوَّض بشكل صحيح. |
forbidden (403) |
forbidden |
لا يمتلك المستخدم الذي تمت مصادقته أذونات لتحميل صور مصغّرة مخصّصة للفيديوهات وضبطها. |
notFound (404) |
videoNotFound |
يتعذر العثور على الفيديو الذي تحاول إدراج صورة مصغّرة له. تحقّق من قيمة معلَمة videoId للطلب للتأكّد من صحتها. |
tooManyRequests (429) |
uploadRateLimitExceeded |
تم تحميل عدد كبير جدًا من الصور المصغّرة على القناة مؤخرًا. يُرجى إعادة محاولة الطلب لاحقًا. |
videoAbuseReportReasons
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد videoAbuseReportReasons
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
videoAbuseReportReasons.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
forbidden |
الدخول محظور. قد لا يكون الطلب مفوَّضًا بشكل صحيح. |
videoCategories
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد videoCategories
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
videoCategories.list
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
notFound (404) |
videoCategoryNotFound |
يتعذّر العثور على فئة الفيديو التي حدّدتها المعلَمة id . استخدِم الطريقة videoCategories.list لاسترداد قائمة بالقيم الصالحة. |
الفيديوهات
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد videos
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
videos.insert
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
يحاول الطلب إضافة تفاصيل الفيديو المترجَم بدون تحديد اللغة التلقائية لتفاصيل الفيديو. |
badRequest (400) |
invalidCategoryId |
تحدّد السمة snippet.categoryId معرّف فئة غير صالح. استخدِم طريقة videoCategories.list لاسترداد الفئات المتوافقة. |
badRequest (400) |
invalidDescription |
تحدد البيانات الوصفية للطلب وصف فيديو غير صالح. |
badRequest (400) |
invalidFilename |
اسم ملف الفيديو المحدّد في عنوان Slug غير صالح. |
badRequest (400) |
invalidPublishAt |
تحدد البيانات الوصفية للطلب وقت نشر مجدول غير صالح. |
badRequest (400) |
invalidRecordingDetails |
يحدّد العنصر recordingDetails في البيانات الوصفية للطلب تفاصيل التسجيل غير الصالحة. |
badRequest (400) |
invalidTags |
تحدّد البيانات الوصفية للطلب كلمات رئيسية غير صالحة للفيديو. |
badRequest (400) |
invalidTitle |
تحدّد البيانات الوصفية للطلب عنوان فيديو غير صالح أو فارغ. |
badRequest (400) |
invalidVideoGameRating |
تحدّد البيانات الوصفية للطلب تقييمًا غير صالح للعبة فيديو. |
badRequest (400) |
invalidVideoMetadata |
البيانات الوصفية للطلب غير صالحة. يحدث هذا الخطأ إذا عدَّل الطلب الجزء snippet من مورد video مع عدم ضبط قيمة لكل من السمتَين snippet.title وsnippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
لا يتضمّن الطلب محتوى الفيديو. |
badRequest (400) |
uploadLimitExceeded |
تجاوز المستخدم عدد الفيديوهات التي يمكن تحميلها. |
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
. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.
watermarks.set
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
تنسيق الصورة التي قدّمتها غير متوافق. |
badRequest (400) |
imageTooTall |
الصورة التي قدّمتها طويلة جدًا. |
badRequest (400) |
imageTooWide |
الصورة التي قدّمتها عريضة جدًا. |
badRequest (400) |
mediaBodyRequired |
لا يتضمّن الطلب محتوى الصورة. |
forbidden (403) |
forbidden |
لا يمكن ضبط العلامة المائية للقناة المحدّدة. قد يكون الطلب غير مصرّح به بشكل صحيح أو تم ضبط المَعلمة channelId على قيمة غير صالحة. |
watermarks.unset
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
forbidden |
لا يمكن إلغاء ضبط العلامة المائية للقناة المحدّدة. قد يكون الطلب غير مصرّح به بشكل صحيح أو تم ضبط المَعلمة channelId على قيمة غير صالحة. |
comments
comments.markAsSpam
متاحة.تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً للطلبات ذات الصلة بموارد
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
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
notFound (404)
commentNotFound
id
في نص الطلب للتأكّد من صحتها.