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

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