Method: invitations.create

Crea una invitación. Solo puede haber una invitación a la vez para un usuario y un curso. Borre y vuelva a crear una invitación para realizar cambios.

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 para este curso o para 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 esta función o una con mayores permisos.
    • para los siguientes errores de solicitud:
      • No apto
  • 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.