Method: users.messages.insert

Inserta directamente un mensaje solo en el buzón de este usuario, similar a IMAP APPEND, y omite la mayor parte del análisis y la clasificación. No envía un mensaje.

Solicitud HTTP

  • URI de carga para solicitudes de carga de contenido multimedia:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
  • URI de metadatos, para solicitudes solo de metadatos:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

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

Parámetros de ruta de acceso

Parámetros
userId

string

La dirección de correo electrónico del usuario. Se puede usar el valor especial me para indicar el usuario autenticado.

Parámetros de consulta

Parámetros
internalDateSource

enum (InternalDateSource)

Fuente de la fecha interna del mensaje en Gmail.

deleted

boolean

Marcar el correo electrónico como borrado de forma permanente (no TRASH) y que solo sea visible en Google Vault para un administrador de Vault Solo se usa en cuentas de Google Workspace.

Cuerpo de la solicitud

El cuerpo de la solicitud incluye una instancia de Message.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Message.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

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