Method: courses.create

สร้างหลักสูตร

ผู้ใช้ที่ระบุใน ownerId จะเป็นเจ้าของหลักสูตรที่สร้างขึ้นและถูกเพิ่มเป็นครู ผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบที่ส่งคำขอจะสร้างหลักสูตรที่มีตนเองเป็นเจ้าของได้เท่านั้น ผู้ดูแลระบบโดเมนสามารถสร้างหลักสูตรที่เป็นเจ้าของโดยผู้ใช้ในโดเมนได้

เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ส่งคำขอไม่มีสิทธิ์สร้างหลักสูตรหรือเกิดข้อผิดพลาดในการเข้าถึง
  • NOT_FOUND หากครูหลักไม่ใช่ผู้ใช้ที่ถูกต้อง
  • FAILED_PRECONDITION หากบัญชีของเจ้าของหลักสูตรถูกปิดใช้หรือเกิดข้อผิดพลาดของคำขอต่อไปนี้:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • ALREADY_EXISTS หากมีการระบุชื่อแทนใน id และชื่อแทนนั้นมีอยู่แล้ว

คำขอ HTTP

POST https://classroom.googleapis.com/v1/courses

URL ใช้ ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
previewVersion

enum (PreviewVersion)

ไม่บังคับ เวอร์ชันตัวอย่างของ API คุณต้องตั้งค่านี้เพื่อเข้าถึงความสามารถใหม่ของ API ที่พร้อมให้บริการแก่นักพัฒนาแอปในโปรแกรมทดลองใช้

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Course

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Course ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์