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 يتعذّر إكمال الطلب لأنّك تجاوزت الحصة المخصّصة لك.