Method: courses.announcements.create

إنشاء إشعار

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يتم السماح للمستخدم الذي قدَّم الطلب بالوصول إلى الدورة التدريبية المطلوبة أو إنشاء إشعارات في الدورة التدريبية المطلوبة أو مشاركة مرفق في Drive أو عن أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح
  • NOT_FOUND في حال عدم توفُّر الدورة التدريبية المطلوبة.
  • FAILED_PRECONDITION عن خطأ الطلب التالي:
    • المرفق غير مرئي

طلب HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
courseId

string

رقم تعريف الدورة التدريبية ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو alias.

نص الطلب

يحتوي نص الطلب على مثال Announcement.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على نسخة افتراضية تم إنشاؤها حديثًا من Announcement.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.announcements

لمزيد من المعلومات، اطّلِع على دليل التفويض.