Descripción general de la API de Gmail
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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
A continuación, se incluye una lista de términos comunes que se usan en la API de Gmail:
- 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 un recurso de mensaje.
- Thread
- 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.
- 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. 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. Una etiqueta de usuario se representa con un recurso de etiqueta.
- Borrador
Es un mensaje que no se envió. 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 un recurso de borrador.
Próximos pasos
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-04 (UTC)
[null,null,["Última actualización: 2025-08-04 (UTC)"],[],[],null,["The Gmail API is a RESTful API that can be used to access Gmail mailboxes and\nsend mail. For most web applications the Gmail API is the best choice for\nauthorized access to a user's Gmail data and is suitable for various\napplications, such as:\n\n- Read-only mail extraction, indexing, and backup\n- Automated or programmatic message sending\n- Email account migration\n- Email organization including filtering and sorting of messages\n- Standardization of email signatures across an organization\n\nFollowing is a list of common terms used in the Gmail API:\n\n*Message*\n: An email message containing the sender, recipients, subject, and body. After a\n message has been created, a message cannot be changed. A message is represented\n by a [message resource](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n*Thread*\n: A collection of related messages forming a conversation. In an email client\n app, a thread is formed when one or more recipients respond to a message with\n their own message.\n\n*Label*\n\n: A mechanism for organizing messages and threads. For example,\n the label \"taxes\" might be created and applied to all messages and threads\n having to do with a user's taxes. There are two types of labels:\n\n *System labels*\n : Internally-created labels, such as `INBOX`, `TRASH`, or `SPAM`. These labels\n cannot be deleted or modified. However, some system labels, such as `INBOX`\n can be applied to, or removed from, messages and threads.\n\n *User labels*\n : Labels created by a user. These labels can be deleted or modified by the\n user or an application. A user label is represented by a\n [label resource](/workspace/gmail/api/reference/rest/v1/users.labels).\n\n*Draft*\n\n: An unsent message. A message contained within the draft can be replaced.\n Sending a draft automatically deletes the draft and creates a message with\n the `SENT` system label. A draft is represented by a\n [draft resource](/workspace/gmail/api/reference/rest/v1/users.drafts).\n\nNext steps\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Gmail API app, read the\n [Quickstarts overview](/workspace/gmail/api/guides/quickstarts-overview)."]]
