Smartsheet

O conetor do Smartsheet permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do Smartsheet.

Versões suportadas

Este conetor suporta a versão 25.2.0.246 do Smartsheet.

Antes de começar

Antes de usar o conector do Smartsheet, conclua as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
    • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. Para mais informações, consulte o artigo Criar uma conta de serviço.

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

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + CRIAR NOVO para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clique em SEGUINTE.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conetor: selecione Smartsheet na lista pendente de conetores disponíveis.
    2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
    3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Cabeçalho: opcionalmente, especifique este campo para detetar os nomes das colunas a partir da primeira linha.
    8. Ocultar carateres de formatação: opcionalmente, especifique este campo para ocultar símbolos de moeda e sinais de percentagem em valores numéricos. Esta ação também converte estas colunas de varchar para double.
    9. Ignorar linhas não encontradas: opcionalmente, se este campo não for selecionado e nenhum dos IDs das linhas especificados for encontrado, não são eliminadas linhas e é devolvido um erro "não encontrado".
    10. Nível de compatibilidade do relatório: opcionalmente, especifique o nível de compatibilidade dos dados devolvidos.
    11. Usar caminhos completos de ficheiros como nomes de tabelas: opcionalmente, especifique este campo para incluir o caminho completo do ficheiro no nome de uma tabela ou vista exposta, correspondente a uma folha ou a um relatório.
    12. Origem do valor: opcionalmente, indica se a célula vai usar os campos de valor como o respetivo valor ou o campo DisplayValue.
    13. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    14. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    15. Clique em SEGUINTE.
  5. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Smartsheet:

      • OAuth2.0 – Código de autorização
      • Token de acesso pessoal
    2. Clique em SEGUINTE.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo dos vários campos que configura quando cria a associação.

Tipo de ligação de autenticação OAuth 2.0

Nome do campo Detalhes
Localização us-central1
Conetor smartsheet
Versão do conetor 1
Nome da ligaçã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
Âmbitos 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
Segredo do cliente CLIENT_SECRET
Versão do Secret 1
URL de autorização https://app.smartsheet.com/b/authorize

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

Nome do campo Detalhes
Localização us-central1
Conetor smartsheet
Versão do conetor 1
Nome da ligaçã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

Pode criar uma conta do Smartsheet através do link Início de sessão 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 um máximo de 10 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

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

Use a ligação do Smartsheet numa integração

Depois de criar a associação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Ações

Esta secção mostra como realizar algumas das ações neste conector.

Ação DownloadAttachment

Esta ação transfere um anexo de uma página.

Introduza os parâmetros da ação DownloadAttachment

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

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

Ação DeleteAttachment

Esta ação elimina um anexo especificado de uma página.

Introduza os parâmetros da ação DeleteAttachment

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

Por exemplo, para saber como configurar a ação DeleteAttachment, consulte os exemplos.

Ação CopyRowsToAnotherSheet

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

Introduza os parâmetros da ação CopyRowsToAnotherSheet

Nome do parâmetro Tipo de dados Obrigatória Descrição
SheetId String Verdadeiro O identificador exclusivo da folha a partir da qual as linhas vão ser copiadas.
RowIds String Verdadeiro Uma lista de IDs de linhas separada por vírgulas a copiar da folha.
DestinationSheetId String Verdadeiro O identificador exclusivo da folha de destino para a qual as linhas vão ser copiadas.

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

Ação CopySheet

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

Introduza os parâmetros da ação CopySheet

Nome do parâmetro Tipo de dados Obrigatória Descrição
SheetId String Verdadeiro O identificador exclusivo da folha a copiar.
DestinationType String Verdadeiro O tipo de destino para o qual a página vai ser copiada. Os valores aceites são folder, home ou workspace.
DestinationId String Verdadeiro O identificador exclusivo do destino para o qual a folha vai ser copiada. Este campo é obrigatório quando o DestinationType é folder ou workspace e tem de ser nulo quando é home.
NewName String Verdadeiro O nome pretendido da folha copiada.
Incluir String Falso Uma lista separada por vírgulas de elementos adicionais da folha a incluir na operação de cópia. Os valores aceites são anexos, cellLinks, dados, discussões, filtros, formulários, ruleRecipients, regras e partilhas.

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

MoveRowsToAnotherSheet action

Esta ação move linhas de uma folha para outra.

Introduza os parâmetros da ação MoveRowsToAnotherSheet

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

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

Ação MoveSheet

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

Introduza os parâmetros da ação MoveSheet

Nome do parâmetro Tipo de dados Obrigatória Descrição
SheetId String Verdadeiro O identificador exclusivo da folha a mover.
DestinationType String Verdadeiro O tipo de destino para onde a folha vai ser movida. Os valores aceites são folder, home ou workspace.
DestinationId String Verdadeiro O identificador exclusivo do destino para o qual a folha vai ser movida. Este campo é obrigatório quando o DestinationType é folder ou workspace e tem de ser nulo quando é home.

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

Exemplos de ações

Esta secção mostra como realizar alguns dos exemplos de ações neste conetor.

Exemplo: transferir um anexo

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadAttachment e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza 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 ao seguinte:

     [
  {
    "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: elimine um anexo

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DeleteAttachment e, de seguida, clique em Concluído.
  3. Na secção Mapeador de dados do editor de Tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}

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

    [
  {
    "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, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
      {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}

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

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

Exemplo: copie uma página

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CopySheet e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza 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 devolve uma resposta semelhante à seguinte na variável de saída da tarefa do conetor connectorOutputPayload:

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

Exemplo: mova linhas para outra página

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MoveRowsToAnotherSheet e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}

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

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

Exemplo: mova uma página

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MoveSheet e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
    {
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252"
}

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

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

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: listar todas as colunas de uma página

  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, de seguida, clique em Concluído.
  4. Na secção Entrada de tarefas da tarefa Conetores, pode definir a filterClause de acordo com o requisito do cliente.

    5. Tem de usar aspas simples (') para incluir o valor de uma cláusula de filtro. Pode usar o filterClause para filtrar registos com base nas colunas.

Exemplo: obter detalhes das colunas de uma página

  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, de seguida, clique em Concluído.
  4. Defina o entityId como "849633317179268", que é a chave a ser transmitida. Para definir o entityId, na secção Data Mapper de Data Mapping, clique em Open Data Mapping Editor e, em seguida, introduza "849633317179268" no campo Input Value e escolha o entityId como variável local.

    5. O valor de entityId deve ser transmitido diretamente, como "849633317179268". Aqui, "849633317179268" é o valor da chave principal exclusivo, que tem de ser transmitido

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

Exemplo: elimine 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, de seguida, clique em Concluído.
  4. Defina o entityId como "849633317179268", que é a chave a ser transmitida. Para definir o entityId, na secção Data Mapper de Data Mapping, clique em Open Data Mapping Editor e, em seguida, introduza "849633317179268" no campo Input Value e escolha o entityId como variável local.

    5. Se a entidade tiver duas chaves empresariais ou principais compostas em vez de especificar o entityId, também pode definir o filterClause como id='849633317179268'.

Exemplo: crie um anexo a 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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {
  "SheetId": "5141926996037508",
  "RowId": "8196592918597508",
  "Name": "Random.txt",
  "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
}

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

    {"Id": "7144235189178244" }

Exemplo: crie um projeto numa linha com prazos fixos usando um esquema de 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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660"}

Exemplo: crie uma tarefa de equipa numa linha de uma folha

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660"}

Exemplo: crie uma atividade de vendas numa linha de uma folha

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660"}

Exemplo: crie uma oportunidade de vendas numa linha de uma página

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660" }

Exemplo: crie um relatório de vendas numa linha de uma folha

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660" }

Exemplo: crie uma encomenda numa linha de uma página

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "Created from googlecloud"}

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

    {"RowId": "7860088629366660" }

Exemplo: crie uma nova coluna numa folha

  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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {
  "SheetId": "3315287605596036",
  "Title": "newexposedcolumn",
  "Index": 2,
  "Type": "DATE"
}

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

    {
  "Id": "550917885349764"
}

Exemplo: criar uma nova pasta num 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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {
  "ParentFolderId": "8716915511191428",
  "Name": "sub-folder-p2"
}

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

    {
  "Id": "550917885349764"
}

Exemplo: crie um novo espaço de trabalho numa 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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {
  "Name": "new workspace (newly exposed)"
}

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

    {
  "Id": "550917885349764"
}

Exemplo: crie um novo utilizador numa 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, de seguida, clique em Concluído.
  4. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza 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 devolve uma resposta semelhante à seguinte na variável de saída da tarefa do conetor connectorOutputPayload:

    {
  "Id": "550917885349764"
}

Exemplo: atualize os detalhes do projeto numa página

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, de seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
     {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Exemplo: atualize uma tarefa de equipa numa folha

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, de seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Exemplo: atualize uma atividade de vendas numa folha

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, em seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
     {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Exemplo: atualize uma oportunidade de vendas numa página

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, em seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Exemplo: atualize um relatório de vendas numa folha

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, em seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Exemplo: atualize uma encomenda numa página

  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, de seguida, clique em Concluído.
  4. Defina o entityId na secção Mapeador de dados das Tarefas, clique em entityId e, em seguida, introduza 849633317179268 no campo indicado.
  5. Na secção Mapeamento de dados do editor de tarefas, clique em Open Data Mapping e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value: 
    {"Task Name": "updated from googlecloud"}

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

    {
  "RowId": null
}

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?