Consulta los conectores compatibles con Application Integration.

Tarea Sheets - Append

La tarea Hojas de cálculo: Append te permite agregar datos después de una tabla de datos específica en una hoja de cálculo de Google. Los valores nuevos se agregan a la fila nueva que se crea después de la tabla especificada, a partir de la primera columna de la tabla.

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 Hojas de cálculo: Append:

  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 Sheets - Append.

    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 la tarea Sheets - Append

  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 una lista de 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 Crear integración.
    2. Selecciona una región para la integració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 Integration summary de la barra de herramientas de integración.
    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 Tareas para ver la lista de tareas y conectores disponibles.
  5. Haz clic y coloca el elemento Hojas de cálculo - Adjuntar en el editor de integración.
  6. Haz clic en el elemento Sheets - Append del diseñador para ver el panel de configuración de la tarea Sheets - Append.
  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 - Append:

Propiedad Tipo de datos Descripción
SpreadsheetId Cadena 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

Rango Cadena La notación A1 de un rango para buscar la tabla deseada en la hoja.
IncludeValuesInResponse Booleano Indica si el objeto mostrado debe incluir los valores de las celdas a las que se les agregaron valores.
InsertDataOption enum (InsertDataOption) Indica cómo se modificarán los datos existentes cuando se agregan los datos nuevos.
ValueInputOption enum (ValueInputOption) Indica cómo se interpretan los datos.

Valor predeterminado: INPUT_VALUE_OPTION_UNSPECIFIED

ResponseDateTimeRenderOption enum (DateTimeRenderOption) Indica cómo se representan los valores relacionados con la fecha, la hora y la duración en el resultado.

Valor predeterminado: SERIAL_NUMBER

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

Valor predeterminado: FORMATTED_VALUE

Solicitud JSON El cuerpo de la solicitud es un objeto ValueRange que describe los valores de rango que se escribirán. Consulta la estructura de solicitud JSON.

Resultado de la tarea

La tarea Sheets - Append muestra el resultado de la respuesta que contiene un objeto AppendValuesResponse, similar al siguiente resultado de muestra:

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

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.

Cuotas y límites

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

¿Qué sigue?