Method: invitations.create

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_DENIED si el usuario que realiza la solicitud no tiene permiso para crear invitaciones a este curso o para errores de acceso.
  • NOT_FOUND si 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_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 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.