YouTube Data API - Errors

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

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

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

Core API errors

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

Common request errors

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

Request context errors

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

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

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

الأنشطة

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

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

activities.list

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

ترجمة وشرح

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

captions.delete

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

captions.download

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

captions.insert

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) contentRequired لا يحتوي الطلب على محتوى مسار الترجمة والشرح.
conflict (409) captionExists سبق أن تم تحديد مسار ترجمة إلى الفيديو المحدّد بالسمتَين snippet.language وsnippet.name. يمكن أن يتضمّن الفيديو عدة مقاطع صوتية باللغة نفسها، ولكن يجب أن يكون لكل مقطع صوتي اسمًا مختلفًا.

ثمة طرق متعددة لمعالجة الخطأ. يمكنك حذف المقطع الصوتي الحالي ثم إدراج مسار جديد أو تغيير اسم المقطع الصوتي الجديد قبل إدراجه.
forbidden (403) forbidden الأذونات المرتبطة بالطلب غير كافية لتحميل مسار الترجمة والشرح. قد يكون الطلب غير مفوَّض بشكل صحيح.
invalidValue (400) invalidMetadata يحتوي الطلب على قيم غير صالحة للبيانات الوصفية، ما يمنع إنشاء المقطع الصوتي. تأكَّد من أنّ الطلب يحدد قيمًا صالحة للسمات snippet.language وsnippet.name وsnippet.videoId. يمكن أيضًا تضمين السمة snippet.isDraft، ولكنها ليست مطلوبة.
notFound (404) videoNotFound تعذّر العثور على الفيديو الذي حدّدته المعلَمة videoId.
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. استخدِم الإجراء 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 للتأكّد من صحتها.

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 يجب دمج حساب 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. ويمكن أن تؤدي هذه الطرق أيضًا إلى عرض الأخطاء المُدرجة في قسم أخطاء الطلبات الشائعة.

watermarks.set

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

watermarks.unset

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