Создает Registration , в результате чего Classroom начинает отправлять уведомления из предоставленного feed в пункт назначения, указанный в cloudPubSubTopic .
Возвращает созданную Registration . В настоящее время это будет то же самое, что и аргумент, но с заполненными назначаемыми сервером полями, такими как expiryTime и id .
Обратите внимание, что любое значение, указанное в полях expiryTime или id будет игнорироваться.
Хотя Classroom может проверять cloudPubSubTopic и возвращать ошибки, приложив все усилия, ответственность за его существование и наличие у Classroom разрешения на публикацию лежит на вызывающей стороне.
Этот метод может возвращать следующие коды ошибок:
-
PERMISSION_DENIED, если:- аутентифицированный пользователь не имеет разрешения на получение уведомлений из запрошенного поля; или
- текущий пользователь не предоставил доступ к текущему проекту Cloud с соответствующей областью действия для запрошенного канала. Обратите внимание, что делегирование полномочий на уровне домена в настоящее время для этой цели не поддерживается. Если запрос имеет соответствующую область, но грант не существует, возвращается [Ошибки запроса][Ошибка
@MissingGrant]. - произошла еще одна ошибка доступа .
-
INVALID_ARGUMENT, если:-
cloudPubsubTopicне указан или указанныйcloudPubsubTopicнедействителен; или -
feedне указан или указанныйfeedнедействителен.
-
-
NOT_FOUNDесли:- указанный
feedне может быть найден, или запрашивающий пользователь не имеет разрешения определить, существует ли он; или - указанную тему
cloudPubsubTopicневозможно найти, или Классу не было предоставлено разрешение на публикацию в ней.
- указанный
HTTP-запрос
POST https://classroom.googleapis.com/v1/registrations
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит экземпляр Registration .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Registration .
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/classroom.push-notifications
Дополнительную информацию см. в руководстве по авторизации .