Method: registrations.create

สร้าง Registration ซึ่งจะทำให้ Classroom เริ่มส่งการแจ้งเตือนจาก feed ที่ระบุไปยังปลายทางที่ระบุใน cloudPubSubTopic

แสดงผล Registration ที่สร้างขึ้น ปัจจุบันค่านี้จะเหมือนกับอาร์กิวเมนต์ แต่มีการกรอกข้อมูลในช่องที่เซิร์ฟเวอร์กำหนด เช่น expiryTime และ id

โปรดทราบว่าระบบจะไม่สนใจค่าที่ระบุสำหรับช่อง expiryTime หรือ id

แม้ว่า Classroom อาจตรวจสอบ cloudPubSubTopic และแสดงข้อผิดพลาดอย่างเต็มความสามารถ แต่ผู้เรียกใช้มีหน้าที่รับผิดชอบในการตรวจสอบว่า cloudPubSubTopic มีอยู่จริงและ Classroom มีสิทธิ์เผยแพร่ใน cloudPubSubTopic ดังกล่าว

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

  • PERMISSION_DENIED if:
    • ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วไม่มีสิทธิ์รับการแจ้งเตือนจากช่องที่ขอ หรือ
    • ผู้ใช้ปัจจุบันยังไม่ได้ให้สิทธิ์เข้าถึงโปรเจ็กต์ Cloud ในปัจจุบันซึ่งมีขอบเขตที่เหมาะสมสำหรับฟีดที่ขอ โปรดทราบว่าปัจจุบันระบบยังไม่รองรับการมอบสิทธิ์ทั่วทั้งโดเมนเพื่อวัตถุประสงค์นี้ หากคำขอมีขอบเขตที่เหมาะสม แต่ไม่มีการให้สิทธิ์ ระบบจะแสดงผล [ข้อผิดพลาดเกี่ยวกับคำขอ][@MissingGrant error]
    • พบข้อผิดพลาดในการเข้าถึงอีก
  • INVALID_ARGUMENT if:
    • ไม่ได้ระบุ cloudPubsubTopic หรือ cloudPubsubTopic ที่ระบุไม่ถูกต้อง หรือ
    • ไม่ได้ระบุ feed หรือ feed ที่ระบุไม่ถูกต้อง
  • NOT_FOUND if:
    • ไม่พบ feed ที่ระบุ หรือผู้ใช้ที่ส่งคำขอไม่มีสิทธิ์ตรวจสอบว่า feed มีอยู่หรือไม่ หรือ
    • ไม่พบ cloudPubsubTopic ที่ระบุ หรือ Classroom ไม่ได้รับอนุญาตให้เผยแพร่ใน cloudPubsubTopic

คำขอ HTTP

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

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

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

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.push-notifications

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