Gmail API

La API de Gmail te permite ver y administrar los datos del buzón de Gmail, como conversaciones, mensajes y etiquetas.

Servicio: gmail.googleapis.com

Para llamar a este servicio, te recomendamos usar las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la siguiente información cuando realices las solicitudes a la API.

Documento de descubrimiento

Un Documento de descubrimiento es una especificación procesable para describir y consumir las API de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el documento de descubrimiento siguiente:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de la red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://gmail.googleapis.com

Recurso de REST: v1.users

Métodos
getProfile GET /gmail/v1/users/{userId}/profile
Obtiene el perfil de Gmail del usuario actual.
stop POST /gmail/v1/users/{userId}/stop
Deja de recibir notificaciones push del buzón de usuario determinado.
watch POST /gmail/v1/users/{userId}/watch
Configura o actualiza un reloj de notificación push en el buzón de usuario determinado.

Recurso de REST: v1.users.drafts

Métodos
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Crea un nuevo borrador con la etiqueta DRAFT.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
De inmediato y de forma permanente, borra el borrador especificado.
get GET /gmail/v1/users/{userId}/drafts/{id}
Obtiene el borrador especificado.
list GET /gmail/v1/users/{userId}/drafts
Enumera los borradores en el buzón del usuario.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Envía el borrador especificado a los destinatarios en los encabezados To, Cc y Bcc.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Reemplaza el contenido del borrador.

Recurso de REST: v1.users.history

Métodos
list GET /gmail/v1/users/{userId}/history
Enumera el historial de todos los cambios en la casilla de correo determinada.

Recurso de REST: v1.users.labels

Métodos
create POST /gmail/v1/users/{userId}/labels
Crea una etiqueta nueva.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Borra de inmediato y de forma permanente la etiqueta especificada y la quita de todos los mensajes y conversaciones a los que se aplica.
get GET /gmail/v1/users/{userId}/labels/{id}
Obtiene la etiqueta especificada.
list GET /gmail/v1/users/{userId}/labels
Enumera todas las etiquetas en la casilla de correo del usuario.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Aplica un parche a la etiqueta especificada.
update PUT /gmail/v1/users/{userId}/labels/{id}
Actualiza la etiqueta especificada.

Recurso de REST: v1.users.messages

Métodos
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Borra muchos mensajes por ID de mensaje.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Modifica las etiquetas de los mensajes especificados.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Borra el mensaje especificado de forma inmediata y permanente.
get GET /gmail/v1/users/{userId}/messages/{id}
Obtiene el mensaje especificado.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Importa un mensaje solo al buzón de este usuario, con escaneo y clasificación estándar de entrega de correo electrónico similar a la recepción por medio de SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Inserta directamente un mensaje en la casilla de correo de este usuario, similar a IMAP APPEND, y omite la mayor parte del análisis y la clasificación.
list GET /gmail/v1/users/{userId}/messages
Enumera los mensajes en la casilla de correo del usuario.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Modifica las etiquetas del mensaje especificado.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Envía el mensaje especificado a los destinatarios en los encabezados To, Cc y Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Mueve el mensaje especificado a la papelera.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Quita el mensaje especificado de la papelera.

Recurso de REST: v1.users.messages.attachments

Métodos
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Obtiene el adjunto de mensaje especificado.

Recurso de REST: v1.users.settings

Métodos
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Obtiene la configuración de reenvío automático de la cuenta especificada.
getImap GET /gmail/v1/users/{userId}/settings/imap
Obtiene la configuración IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Obtiene la configuración de idioma.
getPop GET /gmail/v1/users/{userId}/settings/pop
Obtiene la configuración de POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Obtiene la configuración de la respuesta automática.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Actualiza la configuración de reenvío automático de la cuenta especificada.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Actualiza la configuración de IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Actualiza la configuración de idioma.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Actualiza la configuración de POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Actualiza la configuración de la respuesta automática.

Recurso de REST: v1.users.settings.cse.identities

Métodos
create POST /gmail/v1/users/{userId}/settings/cse/identities
Crea y configura una identidad de encriptación del cliente con autorización para enviar correo electrónico desde la cuenta de usuario.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Borra una identidad de encriptación del cliente.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Recupera una configuración de identidad de encriptación del cliente.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Enumera las identidades encriptadas del lado del cliente para un usuario autenticado.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Asocia un par de claves diferente con una identidad de encriptación del cliente existente.

Recurso de REST: v1.users.settings.cse.keypairs

Métodos
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Crea y sube una cadena de certificados de claves públicas de S/MIME de encriptación del cliente y metadatos de clave privada para el usuario autenticado.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Desactiva un par de claves de encriptación del cliente.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Activa un par de claves de encriptación del cliente que se desactivó.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Recupera un par de claves de encriptación del lado del cliente existente.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Enumera los pares de claves de encriptación del cliente para un usuario autenticado.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Borra un par de claves de encriptación del cliente de forma inmediata y permanente.

Recurso de REST: v1.users.settings.delegates

Métodos
create POST /gmail/v1/users/{userId}/settings/delegates
Agrega a un delegado con su estado de verificación establecido directamente en accepted, sin enviar ningún mensaje de verificación.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Quita al delegado especificado (que puede ser de cualquier estado de verificación) y revoca cualquier verificación que se haya solicitado para usarla.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Obtiene el delegado especificado.
list GET /gmail/v1/users/{userId}/settings/delegates
Enumera los delegados para la cuenta especificada.

Recurso de REST: v1.users.settings.filters

Métodos
create POST /gmail/v1/users/{userId}/settings/filters
Crea un filtro.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Borra de inmediato y de forma permanente el filtro especificado.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Obtiene un filtro.
list GET /gmail/v1/users/{userId}/settings/filters
Enumera los filtros de mensajes de un usuario de Gmail.

Recurso de REST: v1.users.settings.forwardingAddresses

Métodos
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Crea una dirección de reenvío.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Borra la dirección de reenvío especificada y revoca cualquier verificación que se haya solicitado.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Obtiene la dirección de reenvío especificada.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Enumera las direcciones de reenvío de la cuenta especificada.

Recurso de REST: v1.users.settings.sendAs

Métodos
create POST /gmail/v1/users/{userId}/settings/sendAs
Crea un alias de remitente personalizado “de”.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Borra el alias de Send-As especificado.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Obtiene el alias de Send-As especificado.
list GET /gmail/v1/users/{userId}/settings/sendAs
Enumera los alias de Send-As para la cuenta especificada.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aplica un parche al alias especificado como remitente.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Actualiza un alias de envío como.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Envía un mensaje de verificación a la dirección de alias de envío como especificada.

Recurso de REST: v1.users.settings.sendAs.smimeInfo

Métodos
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Borra la configuración de S/MIME especificada para el alias de envío especificado.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Obtiene la configuración de S/MIME especificada para el alias de envío especificado.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Inserta (sube) la configuración de S/MIME determinada para el alias de envío especificado.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Enumera las opciones de configuración de S/MIME para el alias de Send-As especificado.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Establece la configuración de S/MIME predeterminada para el alias de envío especificado.

Recurso de REST: v1.users.threads

Métodos
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Borra de inmediato y de forma permanente la conversación especificada.
get GET /gmail/v1/users/{userId}/threads/{id}
Obtiene el subproceso especificado.
list GET /gmail/v1/users/{userId}/threads
Enumera las conversaciones en la casilla de correo del usuario.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Modifica las etiquetas aplicadas al subproceso.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Mueve el subproceso especificado a la papelera.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Quita de la papelera el subproceso especificado.