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
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Method: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
