Method: registrations.create

Tạo 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, đối số này sẽ giống với đối số, nhưng với các trường do máy chủ chỉ định, chẳng hạn như expiryTimeid đã được điền vào.

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

Mặc dù Lớp học có thể nỗ lực tối đa để xác thực cloudPubSubTopic và trả về lỗi, nhưng phương thức gọi có trách nhiệm đảm bảo rằng lớp này tồn tại và Lớp học có quyền phát hành mã này.

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 đã 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 Google Cloud hiện tại có phạm vi phù hợp cho nguồn cấp dữ liệu được yêu cầu. Lưu ý rằng việc uỷ quyền trê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 nào được cấp, thì hệ thống sẽ trả về [Lỗi yêu cầu][@MissingGrant lỗi].
    • đã gặp phải lỗi truy cập khác.
  • INVALID_ARGUMENT nếu:
    • không có cloudPubsubTopic nào được chỉ định, hoặc cloudPubsubTopic được chỉ định không hợp lệ; hoặc
    • không có feed nào được chỉ định 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 có tồn tại hay không; hoặc
    • Không thể tìm thấy cloudPubsubTopic được chỉ định hoặc Lớp học chưa được cấp quyền xuất bản lên đó.

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ể mới được tạo của Registration.

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.