indexyz 0.1.4

Biblioteca para interactuar con Google Sheets.

Index 📌 Index es una biblioteca de Python diseñada para facilitar la interacción con Google Sheets mediante las operaciones GET, UPDATE y BATCHUPDATE.

📌 Cómo Obtener las Credenciales para Google Sheets Para utilizar esta biblioteca con Google Sheets, es necesario obtener credenciales de una cuenta de servicio en Google Cloud. Sigue estos pasos para configurarlas correctamente:

1️⃣ Crear un Proyecto en Google Cloud Accede a la Consola de Google Cloud. Crea un nuevo proyecto o selecciona uno existente.

2️⃣ Habilitar la API de Google Sheets En la Consola de Google Cloud, ve a APIs y Servicios > Biblioteca. Busca "Google Sheets API" y haz clic en Habilitar.

3️⃣ Crear una Cuenta de Servicio Ve a APIs y Servicios > Credenciales. Haz clic en Crear credenciales y selecciona Cuenta de servicio. Asigna un nombre y una descripción a la cuenta de servicio. En el apartado de Roles, selecciona Editor. Haz clic en Continuar y luego en Listo.

4️⃣ Descargar el Archivo JSON de Credenciales En la sección de Cuentas de servicio, selecciona la cuenta que creaste. Ve a la pestaña Claves y haz clic en Añadir clave > Crear nueva clave. Selecciona el formato JSON y descarga el archivo. Guarda este archivo en un lugar seguro y añádelo a tu proyecto de Python.

5️⃣ Compartir el Google Sheet con la Cuenta de Servicio Abre tu hoja de Google Sheets. Haz clic en Compartir. Copia el correo electrónico de la cuenta de servicio (se encuentra en la Consola de Google Cloud). Pega el correo en la sección de compartir y otórgale permisos de Editor.

1. initialize_credentials(empresa)

• Propósito: Inicializa las credenciales de Google Sheets usando un archivo JSON.
• Argumentos:
  • empresa: Nombre de la empresa para buscar su archivo JSON de credenciales.
• Retorno: Un servicio de Google Sheets o None si ocurre un error.
• Ejemplo:

  service = Index.initialize_credentials("mi_empresa")
  

2. get_data(service, archivo, hoja, rango=None)

• Propósito: Obtiene datos de una hoja de cálculo de Google Sheets.
• Argumentos:
  • service: Objeto de servicio de Google Sheets.
  • archivo: ID del archivo de Google Sheets.
  • hoja: Nombre de la hoja.
  • rango: Rango de celdas (opcional).
• Retorno: Lista con los datos de la hoja.
• Ejemplo:

  data = Index.get_data(service, "archivo_id", "Hoja1", "A1:B10")
  

3. update_data(service, archivo, hoja, rango, valores)

• Propósito: Actualiza un rango específico en Google Sheets.
• Argumentos:
  • service: Objeto de servicio de Google Sheets.
  • archivo: ID del archivo.
  • hoja: Nombre de la hoja.
  • rango: Rango a actualizar.
  • valores: Nuevos valores para actualizar.
• Retorno: Ninguno (actualiza los datos en Google Sheets).
• Ejemplo:

  Index.update_data(service, "archivo_id", "Hoja1", "A1", [["Nuevo valor"]])
  

4. update_data_locate(service, archivo, hojas, ubicaciones, valores)

• Propósito: Actualiza varias celdas en varias hojas.
• Argumentos:
  • service: Objeto de servicio de Google Sheets.
  • archivo: ID del archivo.
  • hojas: Lista de nombres de hojas.
  • ubicaciones: Lista de ubicaciones a actualizar.
  • valores: Valores a poner en las ubicaciones.
• Retorno: Ninguno (actualiza las celdas en las hojas).
• Ejemplo:

  Index.update_data_locate(service, "archivo_id", ["Hoja1", "Hoja2"], ["A1", "B2"], [["Valor1"], ["Valor2"]])
  

5. get_index(data_cliente, columnas=None, filas=None)

• Propósito: Obtiene un subconjunto de datos seleccionados por columnas y filas.
• Argumentos:
  • data_cliente: Datos de la hoja.
  • columnas: Letras de columnas o rangos.
  • filas: Índices de filas.
• Retorno: Subconjunto de datos.
• Ejemplo:

  data_subset = Index.get_index(data_cliente, columnas=["A", "B"], filas=[1, 2])
  

6. print_matriz(matriz)

• Propósito: Imprime una matriz (lista de listas) en formato tabular.
• Argumentos:
  • matriz: La matriz a imprimir.
• Retorno: Ninguno (solo imprime).
• Ejemplo:

  Index.print_matriz([["A", "B"], ["C", "D"]])
  

¡Listo! Ahora puedes usar la biblioteca para interactuar con Google Sheets.