Method: invitations.create

Crea una invitación. Solo se puede enviar una invitación para un usuario y un curso a la vez. Borra una invitación y vuelve a crearla para hacer cambios.

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

  • PERMISSION_DENIED si el usuario solicitante no tiene permiso para crear invitaciones para este curso o por errores de acceso.
  • NOT_FOUND si el curso o el usuario no existen.
  • FAILED_PRECONDITION:
    • si la cuenta del usuario solicitado está inhabilitada.
    • si el usuario ya tiene este rol o uno con permisos más amplios.
    • para los siguientes errores de solicitud:
      • IneligibleOwner
  • ALREADY_EXISTS si ya existe una invitación para el usuario y el curso especificados.

Solicitud HTTP

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

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Invitation.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Invitation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/classroom.rosters

Para obtener más información, consulta la Guía de autorización.