Method: registrations.create

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

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

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

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

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

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

คำขอ HTTP

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

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

เนื้อหาของคำขอ

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

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

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

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

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

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

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