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 correos electrónicos. Para la mayoría de las aplicaciones web, la API de Gmail es la mejor opción para acceder de forma autorizada a los datos de Gmail de un usuario y es adecuada para diversas aplicaciones, como las siguientes:

  • Extracción, indexación y copia de seguridad de correo electrónico de solo lectura
  • Envío de mensajes automatizado o programático
  • Migración de cuentas de correo electrónico
  • Organización de correos electrónicos, incluido el filtrado y la clasificación de mensajes
  • Estandarización de las firmas de correo electrónico en toda la 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 de correo 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 sin enviar. Se puede reemplazar un mensaje contenido en el borrador. Cuando envías un borrador, este se borra automáticamente y se crea un mensaje con la etiqueta del sistema SENT. Un borrador se representa con el recurso drafts. Para obtener más información, consulta Trabaja con borradores.
Filtros
Reglas avanzadas configuradas para una cuenta que evalúan los mensajes entrantes según 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

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

Existen dos tipos de etiquetas:

Etiquetas del sistema
Son etiquetas creadas de forma interna, 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 conversaciones, o quitar de ellos.
Etiquetas de usuarios
Son las etiquetas creadas por un usuario. El usuario o una aplicación pueden borrar o modificar estas etiquetas. La etiqueta de usuario se representa con el recurso labels.
Mensaje

Es 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 recurso messages.

Notificaciones push

Es un sistema de notificaciones del servidor que se integra con Google Cloud Pub/Sub. Las aplicaciones pueden "observar" un buzón de correo, y la API de Gmail enviará webhooks o alertas automáticas 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 del mensaje 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 correos. 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 electrónico como" de 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

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

  • 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, consulta las guías de inicio rápido.