Descripción general de la API de Gmail

La API de Gmail es una API de REST que te permite acceder a las casillas 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 automatizados o programáticos
  • 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 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 Cómo administrar delegados.
Borrador
Un mensaje sin enviar. Puedes reemplazar el mensaje que contiene el borrador. Si envías un borrador, este se borrará automáticamente y se creará un mensaje con la etiqueta del sistema SENT. El recurso drafts representa un borrador. 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 poder usar una dirección en una regla de reenvío o un filtro, debes registrarla y verificarla para demostrar que eres el propietario. Para obtener más información, consulta Administra el reenvío.
Etiqueta

Mecanismo para organizar mensajes y conversaciones Por ejemplo, puedes crear la etiqueta "impuestos" y aplicarla a todos los mensajes y subprocesos relacionados con impuestos. 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. No puedes borrar ni modificar estas etiquetas. Sin embargo, puedes aplicar o quitar algunas etiquetas del sistema, como INBOX, a los mensajes y los subprocesos.
Etiquetas de usuarios
Son etiquetas creadas por un usuario. Un usuario o una aplicación pueden borrar o modificar estas etiquetas. El recurso labels representa una etiqueta del usuario.
Mensaje

Es un mensaje de correo electrónico que contiene el remitente, los destinatarios, el asunto y el cuerpo. Después de crear un mensaje, no puedes cambiarlo. El recurso messages representa un mensaje.

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 envía alertas o webhooks automáticos cada vez que se produce un cambio (por ejemplo, cuando llega un correo electrónico nuevo). Esto elimina la necesidad de que tu app sondee 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 Estos certificados te permiten 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 correos electrónicos. 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 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 un 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.