channel
وvideo
أيضًا على موقع يحدّد الحالة "محتوى مخصّص للأطفال"
على مستوى تلك القناة أو الفيديو. تم أيضًا تعديل بنود الخدمة وسياسات مطوّري برامج YouTube API
في 10 كانون الثاني (يناير) 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّات مراجعة
خدمة YouTube Data API
وبنود خدمة خدمات YouTube API.
تحديث البيانات الوصفية لمقطع فيديو.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
PUT https://www.googleapis.com/youtube/v3/videos
التفويض
ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).
النطاق |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تستخدم المعلمة part غرضين في هذه العملية. تحدد الخصائص التي سيتم تعيينها من خلال عملية الكتابة وكذلك الخصائص التي ستتضمنها استجابة واجهة برمجة التطبيقات.لاحظ أن هذه الطريقة ستتجاوز القيم الحالية لجميع الخصائص القابلة للتغيير المضمّنة في أي أجزاء تحددها قيمة المعلمة. على سبيل المثال، يتم تضمين إعداد خصوصية الفيديو في الجزء status . وبالتالي، إذا كان طلبك يعدّل فيديو خاصًا وكانت قيمة معلمة part للطلب تتضمن الجزء status ، سيتم تعديل إعداد خصوصية الفيديو إلى أي قيمة يحدّدها نص الطلب. إذا لم يحدّد نص الطلب قيمة، ستتم إزالة إعداد الخصوصية الحالي وستتم إعادة الفيديو إلى إعداد الخصوصية التلقائي.بالإضافة إلى ذلك، لا تحتوي جميع الأجزاء على خصائص يمكن ضبطها عند إدراج فيديو أو تعديله. على سبيل المثال، يتضمّن الكائن statistics إحصاءات تحتسبها منصة YouTube لفيديو معيّن ولا يحتوي على قيم يمكنك ضبطها أو تعديلها. في حال تحديد قيمة المَعلمة part التي لا تحتوي على قيم متبادلة، سيستمر تضمين part في استجابة واجهة برمجة التطبيقات.تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة:
|
|
المعلّمات الاختيارية | ||
onBehalfOfContentOwner |
string لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء محتوى YouTube. تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب CMS الفعلي الذي يصادق المستخدم معه بمالك محتوى YouTube المحدد. |
نص الطلب
قدِّم مورد فيديو في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
id
snippet.title
– هذه الخاصية مطلوبة فقط إذا كان الطلب يؤدي إلى تحديثsnippet
لموردvideo
.snippet.categoryId
– هذه الخاصية مطلوبة فقط إذا كان الطلب يؤدي إلى تحديثsnippet
لموردvideo
.
-
يمكنك تعيين قيم للخصائص التالية:
snippet.categoryId
snippet.defaultLanguage
snippet.description
snippet.tags[]
snippet.title
status.embeddable
status.license
status.privacyStatus
status.publicStatsViewable
status.publishAt
– في حال ضبط قيمة لهذا الموقع الإلكتروني، عليك أيضًا ضبط السمةstatus.privacyStatus
علىprivate
.status.selfDeclaredMadeForKids
recordingDetails.locationDescription
(متوقف)recordingDetails.location.latitude
(متوقف)recordingDetails.location.longitude
(متوقف)recordingDetails.recordingDate
localizations.(key)
localizations.(key).title
localizations.(key).description
إذا كنت ترسل طلب تعديل، ولم يحدّد طلبك قيمة لموقع يتضمّن قيمة من قبل، سيتم حذف القيمة الحالية للموقع.
الإجابة
إذا نجحت هذه الطريقة، فإنها تعرض مورد فيديو في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
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 |
البيانات الوصفية للطلب غير صالحة. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenEmbedSetting |
يحاول الطلب تعيين إعداد تضمين غير صالح للفيديو. تجدر الإشارة إلى أنّ بعض القنوات قد لا تملك الإذن لعرض مشغّلات مضمّنة لأحداث البث المباشر. راجع مركز مساعدة YouTube للاطلاع على مزيد من المعلومات. |
forbidden (403) |
forbiddenLicenseSetting |
يحاول الطلب تعيين ترخيص غير صالح للفيديو. |
forbidden (403) |
forbiddenPrivacySetting |
يحاول الطلب تعيين إعداد خصوصية غير صالح للفيديو. |
notFound (404) |
videoNotFound |
تعذر العثور على الفيديو الذي تحاول تحديثه. تحقّق من قيمة الحقل id في نص الطلب للتأكّد من صحته. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.