Method: registrations.create

Создает 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

Дополнительную информацию см. в руководстве по авторизации .