Table of Contents
📌 ¿Qué es este módulo?
Google Contacts es un servicio de gestión de contactos que permite almacenar, organizar y sincronizar información de contactos en la nube. Este módulo facilita la creación, búsqueda, organización en grupos y recuperación de contactos directamente desde Saturn Studio.
📚 Descripción de los comandos
👥 List Contacts
Obtener una lista de contactos desde Google Contacts.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Google Contacts necesaria para obtener los contactos. | My Google Contacts credentials |
| Asignar resultado a variable | Variable donde se almacenará el resultado. Ejemplo: {“contact”:[{“name”:”John Doe”,”email”:”johndoe@gmail.com“,”phone”:”3411 63-1104″}]} | {var} |
🔍 Search Contacts
Buscar contactos en Google Contacts.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Google Contacts necesaria para realizar la búsqueda. | My Google Contacts credentials |
| Búsqueda | Texto de búsqueda (nombre, email, teléfono, etc.). | johndoe@example.com |
| Asignar resultado a variable | Variable donde se almacenará el resultado. Ejemplo: [{“name”:”John Doe”,”email”:”johndoe@gmail.com“,”phone”:”3411 63-1104″}] | {var} |
➕ Create Contact
Crear un contacto nuevo en Google Contacts.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Google Contacts necesaria para crear el contacto. | My Google Contacts credentials |
| Nombre | Nombre del contacto. | John |
| Apellido | Apellido del contacto. | Doe |
| Correo electrónico del contacto. | johndoe@example.com | |
| Teléfono | Teléfono del contacto. | +543411631104 |
| Empresa | Empresa asociada al contacto. | Rocketbot |
| Cargo | Cargo o puesto de trabajo. | Software Development |
| Notas | Notas adicionales. | Software Development |
| Asignar resultado a variable | Variable donde se almacenará el resultado. Ejemplo: {“id”:”people/c4875328950379673515″,”name”:”John Doe”,”email”:”johndoe@example.com“,”phone”:”+54331124854″,”company”:”Rocketbot”,”job_title”:”Software Developer”,”notes”:”No Notes”} | {var} |
🗂️ Create Contact Group
Crear un grupo de contactos en Google Contacts.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Google Contacts necesaria para crear un grupo. | My Google Contacts credentials |
| Nombre del grupo | Nombre del grupo de contactos. | Rocketbot |
| Asignar resultado a variable | Variable donde se almacenará el resultado. Ejemplo: {“id”:”contactGroups/c4875328950379673515″,”name”:”Rocketbot”} | {var} |
🔄 Add/Remove Contact to Group
Agregar o quitar un contacto de un grupo en Google Contacts.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Google Contacts necesaria para agregar o quitar contactos del grupo. | My Google Contacts credentials |
| ID del grupo | ID del grupo al que se agregará o del cual se eliminará un contacto. | contactGroups/c4875328950379673515 |
| ID del contacto a agregar | Identificador del contacto que se desea agregar al grupo. | people/c4485739236186815131 |
| ID del contacto a quitar | Identificador del contacto que se desea quitar del grupo. | people/c4485739236186815131 |
| Asignar resultado a variable | Variable donde se almacenará el resultado. Ejemplo: {“group_id”:”contactGroups/1df614328h3je6fb”,”add_contact_id”:”people/c4875328456389623355″,”remove_contact_id”:”people/c4875328456389623355″} | {var} |
🧪 Ejemplo de uso
- List Contacts
Obtener todos los contactos almacenados en la cuenta de Google vinculada. - Search Contacts
Buscar un contacto específico usando email o número de teléfono como referencia. - Create Contact
Crear un nuevo contacto con nombre, correo, empresa y teléfono. - Create Contact Group
Crear un grupo de contactos llamado “Rocketbot”. - Add/Remove Contact to Group
Agregar un contacto al grupo o eliminarlo mediante su ID correspondiente.
🧩 Requisitos
- Tener una credencial válida de Google Contacts configurada en Saturn Studio.
- Para crear o modificar grupos y contactos, es necesario tener permisos de escritura sobre la cuenta.
- Los IDs de contacto y grupo deben provenir de una búsqueda o consulta previa para ser válidos.