Descripción general de la API de Gmail

La API de Gmail es una API de REST que se puede usar para acceder a los buzones de Gmail y enviar correo. Para la mayoría de las aplicaciones web, la API de Gmail es la mejor opción para el acceso autorizado a los datos de Gmail de un usuario y es adecuada para varias aplicaciones, como las siguientes:

  • Extracción, indexación y copia de seguridad de correo de solo lectura
  • Envío de mensajes automatizado o programático
  • Migración de cuentas de correo electrónico
  • Organización del correo electrónico, incluido el filtrado y la clasificación de mensajes
  • Estandarización de firmas de correo electrónico en una organización

Términos comunes

A continuación, se incluye una lista de términos comunes que se usan en esta API:

Delegador y delegado
Un delegador es un usuario de Gmail que otorga acceso al buzón a otro usuario dentro de la misma organización de Google Workspace. El usuario que recibe este acceso es el delegado. Los delegados pueden leer, enviar y borrar mensajes, así como ver y agregar contactos en nombre de la cuenta del delegador. Para obtener más información, consulta Administra delegados.
Borrador
Un mensaje no enviado. Se puede reemplazar un mensaje contenido en el borrador. Si envías un borrador, se borra automáticamente y se crea un mensaje con la etiqueta del sistema SENT. Un borrador se representa con el drafts recurso. Para obtener más información, consulta Trabaja con borradores.
Filtros
Reglas avanzadas configuradas para una cuenta que evalúan los mensajes entrantes en función de criterios de coincidencia específicos (como el remitente, el asunto o el tamaño). Cuando un mensaje coincide, los filtros activan automáticamente acciones como agregar o quitar etiquetas, o reenviar el correo electrónico a una dirección especificada. Para obtener más información, consulta Administra filtros.
Direcciones de reenvío
Direcciones de correo electrónico específicas y verificadas configuradas para recibir mensajes reenviados automáticamente desde la cuenta de un usuario. Antes de que se pueda usar una dirección en una regla o un filtro de reenvío, se debe registrar y verificar oficialmente para demostrar la propiedad. Para obtener más información, consulta Administra el reenvío.
Etiqueta

Un mecanismo para organizar mensajes y threads. Por ejemplo, se puede crear la etiqueta "impuestos" y aplicarla a todos los mensajes y threads relacionados con los impuestos de un usuario. Para obtener más información, consulta Administra etiquetas.

Existen dos tipos de etiquetas:

Etiquetas del sistema
Etiquetas creadas internamente, como INBOX, TRASH o SPAM. Estas etiquetas no se pueden borrar ni modificar. Sin embargo, algunas etiquetas del sistema, como INBOX, se pueden aplicar a mensajes y threads, o quitar de ellos.
Etiquetas de usuario
Etiquetas creadas por un usuario. El usuario o una aplicación pueden borrar o modificar estas etiquetas. Una etiqueta de usuario se representa con el labels recurso.
Mensaje

Un mensaje de correo electrónico que contiene el remitente, los destinatarios, el asunto y el cuerpo. Una vez que se crea un mensaje, no se puede cambiar. Un mensaje se representa con el messages recurso.

Notificaciones push

Un sistema de notificaciones del servidor que se integra con Google Cloud Pub/Sub. Las aplicaciones pueden "observar" un buzón, y la API de Gmail enviará alertas o webhooks automáticos cada vez que se produzca un cambio (como la llegada de un correo electrónico nuevo), lo que elimina la necesidad de que la app sondee continuamente el servidor para obtener actualizaciones. Para obtener más información, consulta Notificaciones push.

Certificados S/MIME

Certificados digitales subidos a alias específicos de "Enviar como" que permiten a un usuario enviar correos electrónicos encriptados y firmados digitalmente, lo que garantiza la seguridad de los mensajes y la autenticidad del remitente. Para obtener más información, consulta Administra certificados S/MIME.

Alias de "Enviar como"

Representan las distintas direcciones de correo electrónico desde las que una cuenta está autorizada para enviar correo. Cada cuenta tiene al menos un alias que representa la dirección de correo electrónico principal. Los alias corresponden a la función "Enviar correo como" en la interfaz web de Gmail y también son la base para configurar firmas de correo electrónico por dirección. Para obtener más información, consulta Administra alias.

Thread

Una colección de mensajes relacionados que forman una conversación. En una app cliente de correo electrónico, se forma un thread cuando uno o más destinatarios responden a un mensaje con su propio mensaje. Para obtener más información, consulta Administra threads.

  • Para obtener información sobre el desarrollo con las APIs de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Desarrolla en Google Workspace.

  • Para obtener información sobre cómo configurar y ejecutar una app de la API de Gmail, lee las guías de inicio rápido.