Method: invitations.create

สร้างคำเชิญ ผู้ใช้และหลักสูตรจะมีคำเชิญได้ครั้งละ 1 รายการเท่านั้น ให้ลบและสร้างคำเชิญใหม่เพื่อทำการเปลี่ยนแปลง

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

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

คำขอ HTTP

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

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

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

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

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

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

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

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

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

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