Consulta los conectores compatibles para Application Integration.

Tarea Sheets - Get

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La tarea Sheets - Get te permite leer y recuperar un solo rango de valores desde una hoja de cálculo de Google.

Hoja de cálculo: Es el objeto principal de Hojas de cálculo de Google que puede contener varias hojas. Cada hoja tiene información estructurada en celdas.

Puedes encontrar el ID de la hoja de cálculo en su URL web. Por ejemplo, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

Hojas de cálculo de Google es una de las muchas soluciones de productividad basadas en la nube que se encuentran en Google Workspace. Te permite crear y editar hojas de cálculo en línea con la funcionalidad de colaboración en tiempo real.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar la tarea Sheets - Get:

1. Habilita la API de Google Sheets (sheets.googleapis.com).

   Habilitar la API de Google Sheets

2. Crea un perfil de autenticación. Application Integration usa un perfil de autenticación para conectarse a un extremo de autenticación de la tarea Hojas de cálculo: Obtener.

   Para obtener información sobre cómo otorgar roles o permisos adicionales a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

3. Comprende las terminologías comunes que se usan en Hojas de cálculo de Google.

Configura las tareas Sheets - Get

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa un nombre y una descripción en el panel Create Integration.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración en la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integraciones para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas disponibles.
5. Haz clic y coloca el elemento Sheets - Get en el editor de integración.
6. Haz clic en el elemento Sheets - Get en el diseñador para ver el panel de configuración de tareas Sheets - Get.
7. Ve a Autenticación y selecciona un perfil de autenticación existente que desees usar.

   Opcional. Si no creaste un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se mencionan en Crea un perfil de autenticación nuevo.

8. Ve a Entrada de tarea y configura los campos de entrada que se muestran con la siguiente tabla de parámetros de entrada de la tarea.

   Los cambios en los campos de entrada se guardan de forma automática.

Parámetros de entrada de la tarea

En la siguiente tabla, se describen los parámetros de entrada de la tarea Sheets - Get:

Propiedad	Tipo de datos	Descripción
SpreadsheetId	String	El ID de la hoja de cálculo. Puedes encontrar el ID de la hoja de cálculo en su URL web. Por ejemplo, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0
MajorDimension	enum (Dimension)	Categoría o dimensión principal que se debe aplicar. Por ejemplo, ROWS o COLUMNS. Valor predeterminado: DIMENSION_UNSPECIFIED
Rango	String	La notación A1 o notación R1C1 del rango del que se recuperarán los valores.
dateTimeRenderOption	enum (DateTimeRenderOption)	Indica cómo se representan los valores relacionados con la fecha, la hora y la duración en el resultado. Nota: dateTimeRenderOption no se considera si el valor especificado para valueRenderOption es FORMATTED_VALUE. Valor predeterminado: SERIAL_NUMBER
ValueRenderOption	enum (ValueRenderOption)	Indica cómo se representan los valores recuperados en el resultado. Valor predeterminado: FORMATTED_VALUE

Resultado de la tarea

La tarea Sheets - Get obtiene el resultado de la respuesta que contiene un objeto ValueRange correspondiente al rango solicitado. A continuación, se muestra un resultado de ejemplo:

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

¿Qué sigue?

1. Agrega perímetros y condiciones perimetrales.
2. Prueba y publica tu integración.
3. Configura un activador.
4. Agrega una tarea de asignación de datos.
5. Consulta todas las tareas para los servicios de Google Cloud.