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ư expiryTime
và id
đã đượ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ặccloudPubsubTopic
được chỉ định không hợp lệ; hoặc - không có
feed
nào được chỉ định hoặcfeed
được chỉ định không hợp lệ.
- không có
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 đó.
- Không thể tìm thấy
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.