Smartsheet

El conector de Smartsheet te permite realizar operaciones de inserción, eliminación, actualización y lectura en los datos de Smartsheet.

Versiones compatibles

Este conector admite la versión 25.2.0.246 de Smartsheet.

Antes de comenzar

Antes de usar el conector de Smartsheet, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
    • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
    • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API de Secret Manager)
      • connectors.googleapis.com (API de conectores)

      Para comprender cómo habilitar servicios, consulta Habilita servicios.

    Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Smartsheet en la lista desplegable de conectores disponibles.
    2. Versión del conector: Selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. Encabezado: De manera opcional, especifica este campo para detectar los nombres de las columnas de la primera fila.
    8. Hide Formatting Characters: De manera opcional, especifica este campo para ocultar los símbolos de moneda y los signos de porcentaje en los valores numéricos. Esto también convertirá estas columnas de varchar a double.
    9. Ignore Rows Not Found: De manera opcional, si este campo no está seleccionado y no se encuentra ninguno de los IDs de fila especificados, no se borrará ninguna fila y se mostrará un error de "no encontrado".
    10. Report Compatibility Level: De manera opcional, especifica el nivel de compatibilidad de los datos devueltos.
    11. Use Full File Paths As Table Names: De manera opcional, especifica este campo para incluir la ruta de acceso completa al archivo en el nombre de una tabla o vista expuesta, que corresponde a una hoja o un informe.
    12. Fuente del valor: De manera opcional, indica si la celda usará los campos de valor como su valor o el campo DisplayValue.
    13. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    14. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    15. Haga clic en SIGUIENTE.
  5. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Smartsheet admite los siguientes tipos de autenticación:

      • OAuth 2.0, código de autorización
      • Token de acceso personal
    2. Haz clic en SIGUIENTE.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.

Tipo de conexión de autenticación OAuth 2.0

Nombre del campo Detalles
Ubicación us-central1
Conector smartsheet
Versión del conector 1
Nombre de la conexión smartsheet-oauth-connection
Cuenta de servicio my-service-account@my-project.iam.gserviceaccount.com
Cantidad mínima de nodos 2
ID de cliente CLIENT_ID
Permisos ADMIN_SHEETS, ADMIN_SIGHTS, ADMIN_USERS, ADMIN_WEBHOOKS, ADMIN_WORKSPACES, CREATE_SHEETS, CREATE_SIGHTS, DELETE_SHEETS, DELETE_SIGHTS, READ_CONTACTS, READ_EVENTS, READ_SHEETS, READ_SIGHTS, READ_USERS, SHARE_SHEETS, SHARE_SIGHTS, WRITE_SHEETS
Secreto del cliente CLIENT_SECRET
Versión del Secret 1
URL de autorización https://app.smartsheet.com/b/authorize

Tipo de conexión de autenticación con token de acceso personal

Nombre del campo Detalles
Ubicación us-central1
Conector smartsheet
Versión del conector 1
Nombre de la conexión smartsheet-accesstoken-connection
Cuenta de servicio my-service-account@my-project.iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Token de acceso personal PERSONAL_ACCESS_TOKEN
Versión del Secret 3

Puedes crear una cuenta de Smartsheet con el vínculo Smartsheet Login.

Para obtener más información sobre la API de Smartsheet, consulta la referencia de la API de Smartsheet.

Limitaciones del sistema

El conector de Smartsheet puede procesar un máximo de 10 transacciones por segundo, por nodo, y regula las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usa la conexión de Smartsheet en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Acciones

En esta sección, se muestra cómo realizar algunas de las acciones en este conector.

Acción DownloadAttachment

Esta acción descarga un archivo adjunto de una hoja.

Parámetros de entrada de la acción DownloadAttachment

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja.
AttachmentID String Verdadero Es el identificador único del archivo adjunto.

Para ver un ejemplo sobre cómo configurar la acción DownloadAttachment, consulta Ejemplos.

Acción DeleteAttachment

Esta acción borra un adjunto especificado de una hoja.

Parámetros de entrada de la acción DeleteAttachment

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja.
AttachmentID String Verdadero Es el identificador único del archivo adjunto.

Para ver ejemplos sobre cómo configurar la acción DeleteAttachment, consulta Ejemplos.

Acción CopyRowsToAnotherSheet

Esta acción copia filas de una hoja a otra.

Parámetros de entrada de la acción CopyRowsToAnotherSheet

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja desde la que se copiarán las filas.
RowIds String Verdadero Es una lista separada por comas de los IDs de las filas que se copiarán de la hoja.
DestinationSheetId String Verdadero Es el identificador único de la hoja de destino a la que se copiarán las filas.

Para ver ejemplos sobre cómo configurar la acción CopyRowsToAnotherSheet, consulta Ejemplos.

Acción CopySheet

Esta acción copia una hoja en una carpeta, un directorio principal o un espacio de trabajo.

Parámetros de entrada de la acción CopySheet

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja que se copiará.
DestinationType String Verdadero Es el tipo de destino al que se copiará la hoja. Los valores aceptados son folder, home o workspace.
DestinationId String Verdadero Es el identificador único del destino al que se copiará la hoja. Este campo es obligatorio cuando DestinationType es folder o workspace, y debe ser nulo cuando es home.
NewName String Verdadero Nombre deseado de la hoja copiada.
Incluir String Falso Es una lista separada por comas de elementos de hoja adicionales que se incluirán en la operación de copia. Los valores aceptados son attachments, cellLinks, data, discussions, filters, forms, ruleRecipients, rules y shares.

Para ver ejemplos sobre cómo configurar la acción CopySheet, consulta Ejemplos.

Acción MoveRowsToAnotherSheet

Esta acción mueve filas de una hoja a otra.

Parámetros de entrada de la acción MoveRowsToAnotherSheet

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja desde la que se moverán las filas.
RowIds String Verdadero Es una lista separada por comas de los IDs de las filas que se deben mover de la hoja.
DestinationSheetId String Verdadero Es el identificador único de la hoja de destino a la que se moverán las filas.

Para ver ejemplos sobre cómo configurar la acción MoveRowsToAnotherSheet, consulta Ejemplos.

Acción MoveSheet

Esta acción mueve una hoja a una carpeta, un directorio principal o un espacio de trabajo.

Parámetros de entrada de la acción MoveSheet

Nombre del parámetro Tipo de datos Obligatorio Descripción
SheetId String Verdadero Es el identificador único de la hoja que se moverá.
DestinationType String Verdadero Es el tipo de destino al que se moverá la hoja. Los valores aceptados son folder, home o workspace.
DestinationId String Verdadero Es el identificador único del destino al que se moverá la hoja. Este campo es obligatorio cuando DestinationType es folder o workspace, y debe ser nulo cuando es home.

Para ver ejemplos sobre cómo configurar la acción MoveSheet, consulta Ejemplos.

Ejemplos de acciones

En esta sección, se muestra cómo realizar algunos de los ejemplos de acciones en este conector.

Ejemplo: Descarga un archivo adjunto

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción DownloadAttachment y haz clic en Listo.
  3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}

    4. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

     [
  {
    "Success": "true",
    "URL": "https://s3.amazonaws.com/SmartsheetB1/37540b4438a6466a973d678484c1fac8?response-content-disposition=attachment%3Bfilename%3D%22TestGOOGLE3.txt%22%3Bfilename*%3DUTF-8%27%27TestGOOGLE3.txt&Signature=rVHv4loce%2BrL4lYPlteTgAmkB%2Bk%3D&Expires=1744826533&AWSAccessKeyId=11950YFEZZJFSSKKB3G2",
    "Content": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
  }
]

Ejemplo: Borra un archivo adjunto

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción DeleteAttachment y haz clic en Listo.
  3. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}

    4. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    [
  {
    "Success": "true",
  }
]

Ejemplo: Copia filas a otra hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CopyRowsToAnotherSheet y haz clic en Listo.
  3. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
      {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}

    4. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

     [
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Ejemplo: Copia una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CopySheet y haz clic en Listo.
  3. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252",
  "NewName": "Copied sheet appears",
  "Include": "comments"
}

    4. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    [
  {
    "Success": "true",
  }
]

Ejemplo: Mueve filas a otra hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción MoveRowsToAnotherSheet y haz clic en Listo.
  3. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}

    4. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    [
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Ejemplo: Mueve una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción MoveSheet y haz clic en Listo.
  3. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252"
}

    4. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    [
  {
    "Success": "true",
  }
]

Ejemplos de operaciones de entidades

En esta sección, se muestra cómo realizar algunas de las operaciones de la entidad en este conector.

Ejemplo: Enumera todas las columnas de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Columns en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.
  4. En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente.

    5. Debes usar comillas simples ("'") para incluir el valor de una cláusula de filtro. Puedes usar filterClause para filtrar registros según las columnas.

Ejemplo: Obtén los detalles de las columnas de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Columns en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece el entityId en "849633317179268", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "849633317179268" en el campo Input Value y elige entityId como variable local.

    5. El valor de entityId se debe pasar directamente, como "849633317179268". Aquí, "849633317179268" es el valor de la clave primaria única, que se debe pasar

    En algunos casos, pasar entityId puede arrojar un error debido a dos claves compuestas. En esos casos, puedes usar filterClause y pasar el valor, como id='849633317179268'.

Ejemplo: Borra una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Team_Task_List_by_Priority en la lista Entity.
  3. Selecciona la operación Delete y haz clic en Listo.
  4. Establece el entityId en "849633317179268", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "849633317179268" en el campo Input Value y elige entityId como variable local.

    5. Si la entidad tiene dos claves comerciales o primarias compuestas, en lugar de especificar entityId, también puedes establecer filterClause en id='849633317179268'.

Ejemplo: Crea un archivo adjunto para una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Attachments en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {
  "SheetId": "5141926996037508",
  "RowId": "8196592918597508",
  "Name": "Random.txt",
  "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"Id": "7144235189178244" }

Ejemplo: Crea un proyecto en una fila con plazos fijos usando un diseño de estilo Gantt

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Gantt_Project_with_Hard_Deadline en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660"}

Ejemplo: Crea una tarea de equipo en una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Team_Task_List_by_Priority en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660"}

Ejemplo: Crea una actividad de ventas en una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Sales_Activity_Tracking_by_Rep_Month en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660"}

Ejemplo: Crea una oportunidad de ventas en una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Simple_Sales_Pipeline en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660" }

Ejemplo: Crea un informe de ventas en una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Report_Sales_Activity_And_Team_Objectives en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660" }

Ejemplo: Crea un pedido en una fila de una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Customer_Order_Tracking_History en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "Created from googlecloud"}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {"RowId": "7860088629366660" }

Ejemplo: Crea una columna nueva en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Columns en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {
  "SheetId": "3315287605596036",
  "Title": "newexposedcolumn",
  "Index": 2,
  "Type": "DATE"
}

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "550917885349764"
}

Ejemplo: Crea una carpeta nueva en un espacio de trabajo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Folders en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {
  "ParentFolderId": "8716915511191428",
  "Name": "sub-folder-p2"
}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "550917885349764"
}

Ejemplo: Crea un lugar de trabajo nuevo en una cuenta

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Workspaces en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {
  "Name": "new workspace (newly exposed)"
}

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "550917885349764"
}

Ejemplo: Crea un usuario nuevo en una cuenta

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Info_Users en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {
  "FirstName": "charlie",
  "Email": "charlie@altostrat.com",
  "LastName": "c",
  "Admin": true,
  "LicensedSheetCreator": true
}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "550917885349764"
}

Ejemplo: Actualiza los detalles del proyecto en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Gantt_Project_with_Hard_Deadline en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
     {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Ejemplo: Actualiza una tarea del equipo en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Team_Task_List_by_Priority en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Asignador de datos del editor de Tarea, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Ejemplo: Actualiza una actividad de ventas en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Sales_Activity_Tracking_by_Rep_Month en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
     {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Ejemplo: Actualiza una oportunidad de ventas en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Simple_Sales_Pipeline en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Ejemplo: Actualiza un informe de ventas en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Report_Sales_Activity_And_Team_Objectives en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Ejemplo: Actualiza un pedido en una hoja

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Sheet_Customer_Order_Tracking_History en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece entityId en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa 849633317179268 en el campo proporcionado.
  5. En la sección Data mapper del editor Task, haz clic en Open Data Mapping y, luego, ingresa un valor similar al siguiente en el campo Input Value: 
    {"Task Name": "updated from googlecloud"}

    6. Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "RowId": null
}

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?