Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
¿Tienes 5 minutos?
Responde una breve encuesta en línea para ayudarnos a mejorar nuestra documentación de Google Workspace.
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 subprocesos, 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
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 Comienza a desarrollar con Google Workspace.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-03 (UTC)"],[],[],null,["|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe 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)."]]
