Consulta los conectores compatibles con Application Integration.

Hojas de cálculo: tarea de obtención por lotes

La tarea Hojas: obtener por lotes te permite leer y recuperar varios intervalos de valores discontinuos de una hoja de cálculo de Google.

Hojas de cálculo de Google es una de las muchas soluciones de productividad basadas en la nube de Google Workspace. Te permite crear y editar hojas de cálculo online con funciones de colaboración en tiempo real.

Antes de empezar

Antes de configurar la tarea Hojas - Obtener por lotes, asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud:

  1. Habilita la API de Hojas de cálculo de Google (sheets.googleapis.com).

    Habilita la API de Hojas de cálculo de Google

  2. Crea un perfil de autenticación. Integración de aplicaciones usa un perfil de autenticación para conectarse a un endpoint de autenticación de la tarea Hojas de cálculo - Obtener por lotes.

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

  3. Consulta información sobre la terminología habitual que se usa en Hojas de cálculo de Google.

Configurar la tarea Hojas - Obtener por lotes

  1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

    Ir a Application Integration

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

    Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Seleccione una integración o haga clic en Crear integración para crear una.

    Si vas a crear una integración:

    1. Escribe un nombre y una descripción en el panel Crear integración.
    2. Selecciona una región para la integración.
    3. Selecciona una cuenta de servicio para la integración. Puede 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 de la barra de herramientas de integración.
    4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

  4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
  5. Haz clic en el elemento Hojas - Obtener por lote y colócalo en el editor de integración.
  6. Haz clic en el elemento Hojas - Obtener por lotes del diseñador para ver el panel de configuración de la tarea Hojas - Obtener por lotes.
  7. Ve a Autenticación y selecciona un perfil de autenticación que quieras usar.

    Opcional. Si no has creado un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se indican en Crear un perfil de autenticación.

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

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

Parámetros de entrada de la tarea

En la siguiente tabla se describen los parámetros de entrada de la tarea Hojas de cálculo - Obtener por lotes:

Propiedad Tipo de datos Descripción
SpreadsheetId Cadena El ID de la hoja de cálculo.

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

MajorDimension enum (Dimension) La categoría o dimensión principal que se debe aplicar. Por ejemplo, ROWS o COLUMNS.

Valor predeterminado: DIMENSION_UNSPECIFIED

Cocinas Cadena La notación A1 o la notación F1C1 del intervalo del que se van a obtener los valores.
DateTimeRenderOption enum (DateTimeRenderOption) Indica cómo se representan en la salida los valores relacionados con la fecha, la hora y la duración.

Valor predeterminado: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) Indica cómo se representan los valores obtenidos en el resultado.

Valor predeterminado: FORMATTED_VALUE

Salida de la tarea

La tarea Hojas de cálculo - Obtener por lotes devuelve la salida de respuesta que contiene un objeto con el ID de la hoja de cálculo y un array de objetos ValueRange correspondientes a cada intervalo solicitado, que se muestran en el orden solicitado. A continuación, se muestra un ejemplo de resultado:

{
        "spreadsheetId": SPREADSHEET_ID,
        "valueRanges": [
          {
            "range": "Sheet1!B1:B1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Cost",20.5,15,100,135.5]
            ]
          },
          {
            "range": "Sheet1!D1:D1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Ship Date",42430,42444,42449,42449]
            ]
          }
        ]
      }

Estrategia de gestión de errores

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

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos