Tools de Gmail
Las 12 operaciones de Gmail que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar mensajesGETLista los mensajes del buzón que coinciden con q y labelIds. Cada elemento tiene solo id y threadId: lee el contenido con Get message. Envía nextPageToken como pageToken para leer la página siguiente.
- Leer mensajeGETObtiene un mensaje con threadId, labelIds y snippet. Con format full, el valor por defecto, payload trae los headers (From, To, Subject, Date, Message-ID) y las partes del cuerpo, cuyo data viene en base64url. Los adjuntos vienen solo como attachmentId y no se descargan.
- Leer conversaciónGETObtiene una conversación con todos sus mensajes. Cada mensaje tiene id, labelIds, snippet y, con format full, el valor por defecto, el payload con los headers y las partes del cuerpo en base64url.
- Enviar mensajePOSTEnvía un email de inmediato a los destinatarios de los headers To, Cc y Bcc de raw y devuelve el mensaje enviado con id, threadId y labelIds. Para responder dentro de una conversación, pasa su threadId, mantén el mismo Subject y define In-Reply-To y References con el Message-ID del mensaje respondido, que Get message devuelve en payload.headers.
- Actualizar etiquetas del mensajePOSTAñade y quita etiquetas de un mensaje y devuelve sus labelIds. Quita UNREAD para marcarlo como leído, quita INBOX para archivarlo, añade STARRED para destacarlo con estrella o añade TRASH para moverlo a la papelera.
- Listar etiquetasGETLista las etiquetas del buzón: las del sistema, como INBOX, SENT, DRAFT, UNREAD, STARRED y SPAM, y las creadas por el usuario. El id de cada una es lo que reciben labelIds, addLabelIds y removeLabelIds.
- Crear etiquetaPOSTCrea una etiqueta y la devuelve con su id, para aplicar con Update message labels. El nombre no puede ser el de una etiqueta del sistema ni el de una etiqueta existente.
- Listar borradoresGETLista los borradores del buzón. Cada elemento tiene el id del borrador y un message con id y threadId: lee el contenido con Get message usando message.id. Envía nextPageToken como pageToken para leer la página siguiente.
- Crear borradorPOSTGuarda un email como borrador sin enviarlo y devuelve el id del borrador y su message con id y threadId. Envíalo después con Send draft.
- Actualizar borradorPUTReemplaza el email completo de un borrador. El id del borrador se mantiene y message.id cambia. Para editar el texto actual, léelo antes con Get message, format raw, usando el message.id de List drafts.
- Enviar borradorPOSTEnvía de inmediato un borrador existente a los destinatarios de sus headers To, Cc y Bcc. El borrador se elimina, y el mensaje enviado vuelve con un nuevo id y la etiqueta SENT.
- Eliminar borradorDELETEElimina un borrador de forma definitiva, sin moverlo a la papelera.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
