Crea una invitación. Solo puede existir una invitación para un usuario y un curso a la vez. Para realizar cambios, borra una invitación y vuelve a crearla.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIEDsi el usuario que realiza la solicitud no tiene permiso para crear invitaciones a este curso o para errores de acceso.NOT_FOUNDsi el curso o el usuario no existen.FAILED_PRECONDITION:- si la cuenta del usuario solicitada está inhabilitada.
- si el usuario ya tiene este rol o uno con permisos mayores.
- para los siguientes errores de solicitud:
- IneligibleOwner
ALREADY_EXISTSsi 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 incluye 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.