Activities: insert

أوقف YouTube نهائيًا ميزة نشر الإشعارات على القناة، ولم يعُد هذا الأسلوب متاحًا.

لمزيد من التفاصيل، يُرجى الانتقال إلى مركز مساعدة YouTube.

ينشر هذا الإجراء إشعارًا في قناة معيّنة. (يجب أن يكون المستخدم الذي يرسل الطلب مخوّلاً بالتصرّف نيابةً عن القناة).

ملاحظة: على الرغم من أنّ مورد activity يمكن أن يحتوي على معلومات حول إجراءات مثل تقييم المستخدم لفيديو أو وضع علامة "مفضّل" على فيديو، عليك استخدام طرق أخرى في واجهة برمجة التطبيقات لإنشاء موارد activity هذه. على سبيل المثال، يمكنك استخدام طريقة videos.rate() في واجهة برمجة التطبيقات لتقييم فيديو وطريقة playlistItems.insert() لوضع علامة على فيديو كفيديو مفضّل.

تأثير الحصة: تبلغ تكلفة الحصة لاستدعاء هذه الطريقة 50 وحدة.

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/activities

التفويض

يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة ومنح الإذن).

النطاق
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المَعلمات التي يتيحها طلب البحث هذا. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المَعلمات المطلوبة
part string
تخدم المَعلمة part غرضَين في هذه العملية. تحدّد هذه السمة الخصائص التي ستضبطها عملية الكتابة، بالإضافة إلى الخصائص التي سيتضمّنها ردّ واجهة برمجة التطبيقات.

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة:
  • contentDetails
  • id
  • snippet

نص الطلب

قدِّم مرجع نشاط في نص الطلب. بالنسبة إلى هذا المرجع:

  • يجب تحديد قيمة للسمات التالية:

    • snippet.description

  • يمكنك ضبط قيم الخصائص التالية:

    • snippet.description
    • contentDetails.bulletin.resourceId

الردّ

في حال نجاح العملية، تعرض هذه الطريقة مورد نشاط في نص الاستجابة.

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) bulletinTextRequired يجب أن يستخدم الطلب السمة description الخاصة بالعنصر snippet لتوفير نص منشور الإشعار.
badRequest (400) invalidMetadata لا تتطابق السمة kind مع نوع رقم التعريف المقدَّم.
forbidden (403) forbidden لم تتم الموافقة على الطلب بشكل صحيح.
notFound (404) playlistNotFound يتعذّر على YouTube العثور على الفيديو الذي تحاول ربطه بمنشور الإعلان. تحقَّق من قيمة السمة contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound يتعذّر على YouTube العثور على الفيديو الذي تحاول ربطه بمنشور الإعلان. تحقَّق من قيمة السمة contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded لا يمكن إكمال الطلب لأنّك تجاوزت الحصة المحدّدة لك.