Are your users using Classroom with Google Meet? Check out the Apps Script quickstart covering how to check student attendance in Google Meet courses.

Method: registrations.create

Crea un Registration , lo que hace que Classroom comience a enviar notificaciones desde la feed proporcionada al destino proporcionado en cloudPubSubTopic .

Devuelve el Registration creado. Actualmente, esto será lo mismo que el argumento, pero con los campos asignados por el servidor, como la hora de expiryTime y la id .

Tenga en cuenta que se ignorará cualquier valor especificado para los campos expiryTime o id .

Si bien Classroom puede validar cloudPubSubTopic y devolver errores en la medida de lo posible, es responsabilidad de la persona que llama asegurarse de que exista y de que Classroom tenga permiso para publicarlo.

Este método puede devolver los siguientes códigos de error:

  • PERMISSION_DENIED si:
    • el usuario autenticado no tiene permiso para recibir notificaciones del campo solicitado; o
    • el usuario actual no ha otorgado acceso al proyecto de Cloud actual con el alcance adecuado para el feed solicitado. Tenga en cuenta que la delegación de autoridad en todo el dominio no se admite actualmente para este propósito. Si la solicitud tiene el alcance adecuado, pero no existe ninguna concesión, se devuelve un [Errores de solicitud][Error de @MissingGrant ].
    • se encuentra otro error de acceso .
  • INVALID_ARGUMENT si:
    • no se especifica cloudPubsubTopic o el cloudPubsubTopic especificado no es válido; o
    • no se especifica ningún feed o el feed especificado no es válido.
  • NOT_FOUND si:
    • no se puede localizar el feed especificado, o el usuario solicitante no tiene permiso para determinar si existe o no; o
    • no se puede ubicar el cloudPubsubTopic especificado o Classroom no tiene permiso para publicar en él.

Solicitud HTTP

POST https://classroom.googleapis.com/v1/registrations

La URL usa la sintaxis de transcodificación de gRPC .

cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Registration .

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Registration recién creada.

Ámbitos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/classroom.push-notifications

Para obtener más información, consulte la Descripción general de OAuth 2.0 .