Consulta los conectores compatibles con Application Integration.

Hojas de cálculo - Añadir tarea

La tarea Hojas - Añadir te permite añadir datos después de una tabla de datos específica en una hoja de cálculo de Google. Los valores nuevos se añaden a la nueva fila que se crea después de la tabla especificada, empezando por la primera columna de la tabla.

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

Asegúrese de realizar las siguientes tareas en su proyecto de Google Cloud antes de configurar la tarea Hojas - Añadir:

  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 - Añadir.

    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 - Añadir

  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 - Añadir y colócalo en el editor de integraciones.
  6. En el diseñador, haz clic en el elemento Hojas - Añadir para ver el panel de configuración de la tarea Hojas - Añadir.
  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 - Añadir:

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

Intervalo Cadena La notación A1 de un intervalo en el que buscar la tabla deseada en la hoja.
IncludeValuesInResponse Booleano Indica si el objeto devuelto debe incluir los valores de las celdas a las que se han añadido valores.
InsertDataOption enum (InsertDataOption) Indica cómo se modificarán los datos que ya haya cuando se añadan los 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 en la salida los valores relacionados con la fecha, la hora y la duración.

Valor predeterminado: SERIAL_NUMBER

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

Valor predeterminado: FORMATTED_VALUE

Solicitud JSON El cuerpo de la solicitud es un objeto ValueRange que describe los valores del intervalo que se van a escribir. Consulta la estructura JSON de la solicitud.

Salida de la tarea

La tarea Hojas - Añadir devuelve la salida de la respuesta que contiene un objeto AppendValuesResponse, similar a la siguiente salida de ejemplo:

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

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