Method: registrations.create

Tạo một Registration, khiến Lớp học bắt đầu gửi thông báo từ feed được cung cấp đến đích được cung cấp trong cloudPubSubTopic.

Trả về Registration đã tạo. Hiện tại, giá trị này sẽ giống với đối số, nhưng các trường do máy chủ chỉ định như expiryTime và id sẽ được điền sẵn.

Xin lưu ý rằng mọi giá trị được chỉ định cho trường expiryTime hoặc id sẽ bị bỏ qua.

Mặc dù Classroom có thể xác thực cloudPubSubTopic và trả về lỗi theo cách tốt nhất, nhưng người gọi phải đảm bảo rằng cloudPubSubTopic tồn tại và Classroom có quyền phát hành nội dung đến cloudPubSubTopic đó.

Phương thức này có thể trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu:
    • người dùng đã xác thực không có quyền nhận thông báo từ trường được yêu cầu; hoặc
    • người dùng hiện tại chưa cấp quyền truy cập vào dự án Cloud hiện tại với phạm vi phù hợp cho nguồn cấp dữ liệu được yêu cầu. Xin lưu ý rằng việc uỷ quyền toàn miền hiện không được hỗ trợ cho mục đích này. Nếu yêu cầu có phạm vi thích hợp nhưng không có quyền cấp, thì hệ thống sẽ trả về [Lỗi yêu cầu][lỗi @MissingGrant].
    • gặp phải một lỗi truy cập khác.
  • INVALID_ARGUMENT nếu:
    • không chỉ định cloudPubsubTopic hoặc cloudPubsubTopic được chỉ định không hợp lệ; hoặc
    • không chỉ định feed hoặc feed được chỉ định không hợp lệ.
  • NOT_FOUND nếu:
    • không thể tìm thấy feed được chỉ định hoặc người dùng yêu cầu không có quyền xác định xem feed đó có tồn tại hay không; hoặc
    • không thể tìm thấy cloudPubsubTopic đã chỉ định hoặc Lớp học chưa được cấp quyền xuất bản vào cloudPubsubTopic đó.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Registration.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Registration mới tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.