Smartsheet

O conector do Smartsheet permite realizar operações de inserção, exclusão, atualização e leitura nos dados do Smartsheet.

Versões compatíveis

Esse conector é compatível com a versão 25.2.0.246 do Smartsheet.

Antes de começar

Antes de usar o conector do Smartsheet, faça o seguinte:

  • No seu projeto do Google Cloud, faça o seguinte:
    • Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
    • Conceda o papel do IAM roles/connectors.admin ao usuário que está configurando o conector.
    • Conceda os seguintes papéis de IAM à conta de serviço que você quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google. Se você não tiver uma conta de serviço, será necessário criar uma. Para mais informações, consulte Como criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Para entender como ativar os serviços, consulte Como ativar serviços.

    Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

Configurar o conector

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + CRIAR NOVO para abrir a página Criar conexão.
  3. Na seção Local, escolha o local da conexão.
    1. Região: selecione um local na lista suspensa.

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em PRÓXIMA.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione Smartsheet na lista suspensa de conectores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
    3. No campo Nome da conexão, insira um nome para a instância de conexão

      Os nomes de conexão precisam atender aos seguintes critérios:

      • Os nomes de conexões podem usar letras, números ou hifens.
      • As letras precisam ser minúsculas.
      • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das conexões não podem exceder 49 caracteres.
    4. Como opção, insira uma Descrição para a instância de conexão.
    5. Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    7. Cabeçalho: se quiser, especifique esse campo para detectar nomes de colunas na primeira linha.
    8. Ocultar caracteres de formatação: especifique esse campo para ocultar símbolos de moeda e porcentagens em valores numéricos. Isso também vai converter essas colunas de varchar para double.
    9. Ignorar linhas não encontradas: opcionalmente, se esse campo não for selecionado e nenhum dos IDs de linha especificados for encontrado, nenhuma linha será excluída, e um erro "não encontrado" será retornado.
    10. Nível de compatibilidade do relatório: especifique o nível de compatibilidade dos dados retornados, se quiser.
    11. Usar caminhos de arquivo completos como nomes de tabela: opcionalmente, especifique esse campo para incluir o caminho completo do arquivo no nome de uma tabela ou visualização exposta, correspondente a uma planilha ou relatório.
    12. Origem do valor: opcionalmente, indica se a célula vai usar os campos "Valor" como valor ou o campo "DisplayValue".
    13. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    14. Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
    15. Clique em PRÓXIMA.
  5. Na seção Autenticação, insira os detalhes da autenticação.
    1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      A conexão do Smartsheet oferece suporte aos seguintes tipos de autenticação:

      • OAuth2.0: código de autorização
      • Token de acesso pessoal
    2. Clique em PRÓXIMA.
  6. Revisão: revise os detalhes de conexão e autenticação.
  7. Clique em Criar.

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

Tipo de conexão de autenticação do OAuth 2.0

Nome do campo Detalhes
Local us-central1
Conector smartsheet
Versão do conector 1
Nome da conexão smartsheet-oauth-connection
Conta de serviço my-service-account@my-project.iam.gserviceaccount.com
Número mínimo de nós 2
ID do cliente CLIENT_ID
Escopos 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
Chave secreta do cliente CLIENT_SECRET
Versão do secret 1
URL de autorização https://app.smartsheet.com/b/authorize

Tipo de conexão de autenticação de token de acesso pessoal

Nome do campo Detalhes
Local us-central1
Conector smartsheet
Versão do conector 1
Nome da conexão smartsheet-accesstoken-connection
Conta de serviço my-service-account@my-project.iam.gserviceaccount.com
Número mínimo de nós 2
Número máximo de nós 50
Token de acesso pessoal PERSONAL_ACCESS_TOKEN
Versão do secret 3

Você pode criar uma conta do Smartsheet usando o link Login do Smartsheet.

Para saber mais sobre a API Smartsheet, consulte a referência da API Smartsheet.

Limitações do sistema

O conector do Smartsheet pode processar no máximo 10 transações por segundo, por , e limita qualquer transação além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Usar a conexão do Smartsheet em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e no Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
  • Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

Ações

Nesta seção, mostramos como realizar algumas das ações neste conector.

Ação DownloadAttachment

Essa ação faz o download de um anexo de uma planilha.

Parâmetros de entrada da ação DownloadAttachment

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha.
AttachmentID String Verdadeiro O identificador exclusivo do anexo.

Para um exemplo de como configurar a ação DownloadAttachment, consulte Exemplos.

Ação DeleteAttachment

Essa ação exclui um anexo especificado de uma planilha.

Parâmetros de entrada da ação DeleteAttachment

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha.
AttachmentID String Verdadeiro O identificador exclusivo do anexo.

Para ver um exemplo de como configurar a ação DeleteAttachment, consulte Exemplos.

Ação CopyRowsToAnotherSheet

Essa ação copia linhas de uma página para outra.

Parâmetros de entrada da ação CopyRowsToAnotherSheet

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha de onde as linhas serão copiadas.
RowIds String Verdadeiro Uma lista separada por vírgulas de IDs de linha a serem copiados da planilha.
DestinationSheetId String Verdadeiro O identificador exclusivo da planilha de destino para onde as linhas serão copiadas.

Para ver um exemplo de como configurar a ação CopyRowsToAnotherSheet, consulte Exemplos.

Ação CopySheet

Essa ação copia uma planilha para uma pasta, um diretório inicial ou um espaço de trabalho.

Parâmetros de entrada da ação CopySheet

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha a ser copiada.
DestinationType String Verdadeiro O tipo de destino para onde a planilha será copiada. Os valores aceitos são "folder", "home" ou "workspace".
DestinationId String Verdadeiro O identificador exclusivo do destino para onde a planilha será copiada. Esse campo é obrigatório quando o DestinationType é "folder" ou "workspace", e precisa ser nulo quando é "home".
NewName String Verdadeiro O nome desejado da planilha copiada.
Incluir String Falso Uma lista separada por vírgulas de elementos extras da planilha a serem incluídos na operação de cópia. Os valores aceitos são anexos, cellLinks, dados, discussões, filtros, formulários, ruleRecipients, regras e compartilhamentos.

Para ver um exemplo de como configurar a ação CopySheet, consulte Exemplos.

Ação MoveRowsToAnotherSheet

Essa ação move linhas de uma planilha para outra.

Parâmetros de entrada da ação MoveRowsToAnotherSheet

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha de onde as linhas serão movidas.
RowIds String Verdadeiro Uma lista separada por vírgulas dos IDs das linhas a serem movidas da planilha.
DestinationSheetId String Verdadeiro O identificador exclusivo da planilha de destino para onde as linhas serão movidas.

Para ver um exemplo de como configurar a ação MoveRowsToAnotherSheet, consulte Exemplos.

Ação MoveSheet

Essa ação move uma planilha para uma pasta, um diretório inicial ou um espaço de trabalho.

Parâmetros de entrada da ação MoveSheet

Nome do parâmetro Tipo de dados Obrigatório Descrição
SheetId String Verdadeiro O identificador exclusivo da planilha a ser movida.
DestinationType String Verdadeiro O tipo de destino para onde a planilha será movida. Os valores aceitos são "folder", "home" ou "workspace".
DestinationId String Verdadeiro O identificador exclusivo do destino para onde a planilha será movida. Esse campo é obrigatório quando o DestinationType é "folder" ou "workspace", e precisa ser nulo quando é "home".

Para ver um exemplo de como configurar a ação MoveSheet, consulte Exemplos.

Exemplos de ações

Nesta seção, mostramos como realizar alguns dos exemplos de ações neste conector.

Exemplo: baixar um anexo

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadAttachment e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:
    {
      "SheetId": "5141926996037508",
      "AttachmentID": "1667587811610500"
    }
    
  4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

     [
      {
        "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="
      }
    ]
    

Exemplo: excluir um anexo

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DeleteAttachment e clique em Concluído.
  3. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Default Value:
    {
      "SheetId": "5141926996037508",
      "AttachmentID": "1667587811610500"
    }
    
  4. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: copiar linhas para outra página

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CopyRowsToAnotherSheet e clique em Concluído.
  3. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Default Value:
      {
      "SheetId": "7483321975000964",
      "RowIds": "7935781927128964",
      "DestinationSheetId": "7197099985686404"
    }
    
  4. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: copiar uma página

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CopySheet e clique em Concluído.
  3. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Default Value:
    {
      "SheetId": "5141926996037508",
      "DestinationType": "workspace",
      "DestinationId": "4219254305253252",
      "NewName": "Copied sheet appears",
      "Include": "comments"
    }
    
  4. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: mover linhas para outra planilha

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MoveRowsToAnotherSheet e clique em Concluído.
  3. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Default Value:
    {
      "SheetId": "7483321975000964",
      "RowIds": "7935781927128964",
      "DestinationSheetId": "7197099985686404"
    }
    
  4. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplo: mover uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MoveSheet e clique em Concluído.
  3. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Default Value:
    {
      "SheetId": "5141926996037508",
      "DestinationType": "workspace",
      "DestinationId": "4219254305253252"
    }
    
  4. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

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

Exemplos de operações de entidade

Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.

Exemplo: listar todas as colunas de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Columns na lista Entity.
  3. Selecione a operação List e clique em Concluído.
  4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com a exigência do cliente.
  5. Use aspas simples (') para incluir o valor de uma cláusula de filtro. Use o filterClause para filtrar registros com base nas colunas.

Exemplo: receber detalhes da coluna de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Columns na lista Entity.
  3. Selecione a operação Get e clique em Concluído.
  4. Defina o entityId como "849633317179268", que é a chave a ser transmitida. Para definir o entityId, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e insira "849633317179268" no campo Input Value. Depois, escolha o entityId como variável local.
  5. O valor de "entityId" precisa ser transmitido diretamente, como "849633317179268". Aqui, "849633317179268" é o valor exclusivo da chave primária, que precisa ser transmitido

    Em alguns casos, a transmissão de entityId pode gerar um erro devido a duas chaves compostas. Nesses casos, você pode usar o filterClause e transmitir o valor, como id='849633317179268'.

Exemplo: excluir uma linha de uma página

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Team_Task_List_by_Priority na lista Entity.
  3. Selecione a operação Delete e clique em Concluído.
  4. Defina o entityId como "849633317179268", que é a chave a ser transmitida. Para definir o entityId, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e insira "849633317179268" no campo Input Value. Depois, escolha o entityId como variável local.
  5. Se a entidade tiver duas chaves primárias ou de negócios compostas em vez de especificar o entityId, você também poderá definir a filterClause como id='849633317179268'.

Exemplo: criar um anexo em uma página

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Attachments na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {
      "SheetId": "5141926996037508",
      "RowId": "8196592918597508",
      "Name": "Random.txt",
      "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
    }
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"Id": "7144235189178244" }
    

Exemplo: criar um projeto em uma linha com prazos fixos usando um layout no estilo Gantt

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Gantt_Project_with_Hard_Deadline na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660"}
    

Exemplo: criar uma atividade em grupo em uma linha de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Team_Task_List_by_Priority na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660"}
    

Exemplo: criar uma atividade de vendas em uma linha de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Sales_Activity_Tracking_by_Rep_Month na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660"}
    

Exemplo: criar uma oportunidade de venda em uma linha de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Simple_Sales_Pipeline na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660" }
    

Exemplo: criar um relatório de vendas em uma linha de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Report_Sales_Activity_And_Team_Objectives na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660" }
    

Exemplo: criar um pedido em uma linha de uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Customer_Order_Tracking_History na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "Created from googlecloud"}
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {"RowId": "7860088629366660" }
    

Exemplo: criar uma coluna em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Columns na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {
      "SheetId": "3315287605596036",
      "Title": "newexposedcolumn",
      "Index": 2,
      "Type": "DATE"
    }
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "Id": "550917885349764"
    }
    

Exemplo: criar uma pasta em um espaço de trabalho

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Folders na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {
      "ParentFolderId": "8716915511191428",
      "Name": "sub-folder-p2"
    }
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "Id": "550917885349764"
    }
    

Exemplo: criar um espaço de trabalho em uma conta

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Workspaces na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {
      "Name": "new workspace (newly exposed)"
    }
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "Id": "550917885349764"
    }
    

Exemplo: criar um usuário em uma conta

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Info_Users na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {
      "FirstName": "charlie",
      "Email": "charlie@altostrat.com",
      "LastName": "c",
      "Admin": true,
      "LicensedSheetCreator": true
    }
    

    A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "Id": "550917885349764"
    }
    

Exemplo: atualizar detalhes do projeto em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Gantt_Project_with_Hard_Deadline na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper das Tasks, clique em entityId e insira 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
     {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Exemplo: atualizar uma tarefa de equipe em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Team_Task_List_by_Priority na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper das Tasks, clique em entityId e insira 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Exemplo: atualizar uma atividade de vendas em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Sales_Activity_Tracking_by_Rep_Month na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper de Tasks, clique em entityId e digite 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
     {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Exemplo: atualizar uma oportunidade de venda em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Simple_Sales_Pipeline na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper de Tasks, clique em entityId e digite 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Exemplo: atualizar um relatório de vendas em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Report_Sales_Activity_And_Team_Objectives na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper de Tasks, clique em entityId e digite 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Exemplo: atualizar um pedido em uma planilha

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Sheet_Customer_Order_Tracking_History na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Defina o entityId na seção Data mapper de Tasks, clique em entityId e digite 849633317179268 no campo indicado.
  5. Na seção Data mapper da Tarefa, clique no editor Open Data Mapping e insira um valor semelhante ao seguinte no campo Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:

    {
      "RowId": null
    }
    

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir