Smartsheet
O Smartsheet é uma poderosa ferramenta de colaboração e gerenciamento de trabalho que permite que você acompanhe e gerencie facilmente seu trabalho para que você e sua equipe possam ser mais produtivos do que nunca. Use-o para colaborar com outras pessoas, acompanhar o progresso em qualquer projeto, automatizar processos e estruturar melhor seu trabalho.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site da Web | https://www.smartsheet.com/ |
| Política de privacidade | https://www.smartsheet.com/legal/privacy |
Para usar essa integração, você precisará de acesso a uma conta do Smartsheet. Para fazer uma conexão, selecione Entrar. Você será solicitado a fornecer suas informações de conta do Smartsheet, siga o restante das telas para criar uma conexão.
Agora você está pronto para começar a usar essa integração.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Frequência das pesquisas de gatilho | 1 | 15 s |
Ações
| Adicionar um comentário a uma discussão |
Adicione um comentário a uma discussão existente. |
| Adicionar uma discussão a uma linha |
Adicione uma discussão a uma linha específica em uma planilha. |
| Adicionar uma discussão a uma planilha |
Adicionar uma discussão a uma planilha |
| Inserir linha |
Insira uma linha em uma planilha específica. |
| Listar as planilhas |
Obtenha uma lista das planilhas. |
| Obter as colunas de uma planilha |
Obtenha as colunas de uma planilha específica. |
| Obter as colunas de uma planilha (esquema dinâmico) |
Obtenha as colunas de uma planilha específica no formato de esquema dinâmico. |
| Obter dados de planilha (esquema dinâmico) |
Obtenha dados específicos da planilha. |
| Obter discussões para uma planilha |
Obtenha as discussões de uma planilha específica. |
| Obter subpastas de uma pasta |
Obter subpastas de uma pasta específica. |
| Obter uma discussão |
Obtenha uma discussão específica. |
| Obter uma planilha |
Obtenha uma planilha específica. |
Adicionar um comentário a uma discussão
Adicione um comentário a uma discussão existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Discussão
|
discussionId | True | string |
A discussão à qual adicionar o comentário. |
|
Texto
|
text | string |
O texto do comentário. |
Retornos
Objeto de resposta para criar um comentário.
- Corpo
- CreateCommentResponse
Adicionar uma discussão a uma linha
Adicione uma discussão a uma linha específica em uma planilha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Lençol
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
ID da linha
|
rowId | True | string |
A ID exclusiva da linha. |
|
Title
|
title | string |
O título da discussão. |
|
|
Texto
|
text | string |
O texto do comentário. |
Retornos
Objeto de resposta para Criar Discussão.
- Corpo
- DiscussionResponse
Adicionar uma discussão a uma planilha
Adicionar uma discussão a uma planilha
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
Planilha para adicionar uma discussão a |
|
Title
|
title | string |
O título da discussão. |
|
|
Texto
|
text | string |
O texto do comentário. |
Retornos
Objeto de resposta para Criar Discussão.
- Corpo
- DiscussionResponse
Inserir linha
Insira uma linha em uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Row
|
row | True | dynamic |
A linha a ser inserida. |
Retornos
Resposta à operação InsertRow.
- Corpo
- InsertRowResponse
Listar as planilhas
Obtenha uma lista das planilhas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta (padrão para todos)
|
optionalFolderId | string |
A ID exclusiva da pasta que contém as planilhas. Se não for especificado, o padrão será todos. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Obter as colunas de uma planilha
Obtenha as colunas de uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Obter as colunas de uma planilha (esquema dinâmico)
Obtenha as colunas de uma planilha específica no formato de esquema dinâmico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
Obter dados de planilha (esquema dinâmico)
Obtenha dados específicos da planilha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Colunas separadas por vírgulas a serem retornadas
|
columns | string |
A lista de colunas a serem retornadas |
Retornos
Obter discussões para uma planilha
Obtenha as discussões de uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Obter subpastas de uma pasta
Obter subpastas de uma pasta específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta
|
id | True | string |
A ID da pasta. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Obter uma discussão
Obtenha uma discussão específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
ID de discussão
|
discussionId | True | string |
A ID exclusiva da discussão na planilha especificada. |
Retornos
Dados relevantes para a discussão criada.
- Corpo
- DiscussionData
Obter uma planilha
Obtenha uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Colunas separadas por vírgulas a serem retornadas
|
columns | string |
A lista de colunas a serem retornadas |
Retornos
Uma planilha smartsheet com linhas.
- Corpo
- SheetWithRows
Gatilhos
| Quando qualquer planilha é atualizada |
Dispara quando qualquer planilha é atualizada. |
| Quando um comentário é adicionado a uma discussão |
Dispara quando um comentário é adicionado a uma discussão específica. |
| Quando um comentário é adicionado a uma planilha |
Dispara quando um comentário é adicionado a uma planilha específica. |
| Quando uma discussão é adicionada a uma planilha |
Dispara quando uma discussão é adicionada a uma planilha. |
| Quando uma nova linha é criada |
Dispara quando uma nova linha é criada em uma planilha específica. |
| Quando uma nova planilha é criada |
Dispara quando uma nova planilha é criada. |
| Quando uma planilha é atualizada |
Dispara quando uma planilha específica é atualizada. |
Quando qualquer planilha é atualizada
Dispara quando qualquer planilha é atualizada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta (padrão para todos)
|
optionalFolderId | string |
A ID exclusiva da pasta que contém as planilhas. Se não for especificado, o padrão será todos. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Quando um comentário é adicionado a uma discussão
Dispara quando um comentário é adicionado a uma discussão específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
ID de discussão
|
discussionId | True | string |
A ID exclusiva da discussão. |
Retornos
Objeto de resposta para Comment.
- Corpo
- CommentResponse
Quando um comentário é adicionado a uma planilha
Dispara quando um comentário é adicionado a uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Quando uma discussão é adicionada a uma planilha
Dispara quando uma discussão é adicionada a uma planilha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Quando uma nova linha é criada
Dispara quando uma nova linha é criada em uma planilha específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Columns
|
columns | string |
A lista separada por vírgulas de colunas. |
Retornos
Objeto de resposta para OnRowCreated.
- Corpo
- RowResponse
Quando uma nova planilha é criada
Dispara quando uma nova planilha é criada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pasta (padrão para todos)
|
optionalFolderId | string |
A ID exclusiva da pasta que contém as planilhas. Se não for especificado, o padrão será todos. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Quando uma planilha é atualizada
Dispara quando uma planilha específica é atualizada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da planilha
|
sheetId | True | string |
A ID exclusiva da planilha. |
|
Colunas a serem retornadas
|
columns | string |
A lista separada por vírgulas de colunas a serem retornadas. |
Retornos
Um padrão comum para solicitar coleções do Smartsheet.
Definições
SmartsheetCollection[Sheet]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of Sheet |
Coleção de modelos smartsheet. |
Lençol
Uma planilha smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nível de Acesso
|
accessLevel | string |
O nível de acesso da planilha. |
|
ID
|
id | integer |
O identificador exclusivo da planilha. |
|
Nome
|
name | string |
O nome da planilha. |
|
URL
|
permalink | string |
A URL da planilha. |
|
Criado em
|
createdAt | date-time |
O datetime quando a planilha foi criada. |
|
Modificado em
|
modifiedAt | date-time |
O datetime em que a planilha foi modificada. |
SmartsheetCollection[DiscussionComment]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of DiscussionComment |
Coleção de modelos smartsheet. |
DiscussionComment
Um comentário sobre uma discussão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto do comentário
|
text | string |
O texto do comentário. |
|
ID do comentário
|
id | integer |
A ID do comentário. |
|
createdBy
|
createdBy | DiscussionCommentUser |
O usuário que criou o comentário. |
|
Criado em
|
createdAt | date-time |
O datetime em que o comentário foi criado. |
|
Modificado em
|
modifiedAt | date-time |
O datetime em que o comentário foi modificado. |
DiscussionCommentUser
O usuário que criou o comentário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Criado por (Nome)
|
name | string |
O nome do usuário que criou um comentário. |
|
Criado por (Email)
|
string |
O email do usuário que criou um comentário. |
SheetWithRows
Uma planilha smartsheet com linhas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
HTML da planilha
|
rowHTML | string |
Uma representação de tabela HTML da planilha. |
|
Nível de Acesso
|
accessLevel | string |
O nível de acesso da planilha. |
|
ID
|
id | integer |
O identificador exclusivo da planilha. |
|
Nome
|
name | string |
O nome da planilha. |
|
URL
|
permalink | string |
A URL da planilha. |
|
Criado em
|
createdAt | date-time |
O datetime em que a planilha foi criada. |
|
Modificado em
|
modifiedAt | date-time |
O datetime em que a planilha foi modificada. |
|
Columns
|
columns | array of Column |
Matriz de colunas. |
|
Rows
|
rows | array of RowData |
Matriz de linhas. |
SmartsheetCollection[Column]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of Column |
Coleção de modelos smartsheet |
Coluna
Uma coluna smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da coluna
|
id | integer |
A ID exclusiva da coluna. |
|
Índice de Coluna
|
index | integer |
A posição ordinal da coluna. |
|
Title
|
title | string |
O título da coluna. |
|
Tipo de Dados
|
type | string |
O tipo de dados da coluna (como text_number ou datetime). |
|
É Primário
|
primary | boolean |
Um valor booliano (true, false) que determina se a coluna é ou não a coluna primária. |
|
Largura
|
width | integer |
A largura em pixels da coluna, |
InsertRowResponse
Resposta à operação InsertRow.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | InsertRowResponseResult |
InsertRowResponseResult
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da planilha
|
sheetId | integer |
A ID da planilha que foi modificada. |
|
Número da linha
|
rowNumber | integer |
O número da linha recém-inserida. |
|
Criado em
|
createdAt | date-time |
O datetime em que a planilha foi criada. |
|
Modificado em
|
modifiedAt | date-time |
O datetime em que a planilha foi modificada. |
SmartsheetCollection[SheetWithRows]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of SheetWithRows |
Coleção de modelos smartsheet. |
SmartsheetCollection[Folder]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of Folder |
Coleção de modelos smartsheet. |
Pasta
Uma pasta smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | integer |
A ID exclusiva da pasta. |
|
Nome
|
name | string |
O nome da pasta. |
|
URL
|
permalink | string |
A URL da pasta. |
DiscussionResponse
Objeto de resposta para Criar Discussão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | DiscussionData |
Dados relevantes para a discussão criada. |
DiscussionData
Dados relevantes para a discussão criada.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de discussão
|
id | integer |
A ID da discussão. |
|
Título da discussão
|
title | string |
O título da discussão. |
|
Comments
|
comments | array of DiscussionComment |
Os comentários na discussão. |
|
createdBy
|
createdBy | DiscussionUser |
O usuário que criou a discussão. |
DiscussionUser
O usuário que criou a discussão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Criado por (Nome)
|
name | string |
O nome do usuário que criou a discussão. |
|
Criado por (Email)
|
string |
O email do usuário que criou a discussão. |
SmartsheetCollection[GetDiscussionResponse]
Um padrão comum para solicitar coleções do Smartsheet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dados
|
data | array of GetDiscussionResponse |
Coleção de modelos smartsheet. |
GetDiscussionResponse
Objeto de resposta para Get Discussions.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de discussão
|
id | integer |
A ID exclusiva da discussão. |
|
Título da discussão
|
title | string |
O título da discussão. |
|
createdBy
|
createdBy | DiscussionUser |
O usuário que criou a discussão. |
|
Nível de Acesso
|
accessLevel | string |
O Nível de acesso para a discussão. |
|
Tipo pai
|
parentType | string |
O tipo pai da discussão. |
|
É Read-Only
|
readOnly | boolean |
Um valor booliano (true, false) que determina se essa discussão é somente leitura ou não. |
|
Último comentário em
|
lastCommentedAt | date-time |
O datetime do comentário mais recente |
RowResponse
Objeto de resposta para OnRowCreated.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Rows
|
rows | array of RowData |
O conteúdo da linha que foi criada. |
RowData
Uma linha
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da linha
|
id | integer |
A ID exclusiva da linha. |
|
ID da planilha
|
sheetId | integer |
A ID da planilha à qual a linha foi adicionada. |
|
URL
|
permalink | string |
A URL da planilha à qual a linha foi adicionada. |
|
Criado em
|
createdAt | date-time |
O datetime em que a linha foi criada. |
|
Modificado em
|
modifiedAt | date-time |
O datetime em que a linha foi modificada. |
|
Número da linha
|
rowNumber | integer |
O número da linha. |
|
Células
|
cells | array of RowCell |
Os detalhes da célula na linha. |
|
HTML da linha
|
rowHTML | string |
Uma representação de tabela HTML da nova linha. |
RowCell
Uma célula em uma linha
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da coluna
|
columnId | integer |
A ID da coluna para essa célula. |
|
Valor da célula
|
value |
O valor da célula. |
|
|
Valor de exibição da célula
|
displayValue | string |
O valor de exibição da célula. |
CreateCommentResponse
Objeto de resposta para criar um comentário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
resultado
|
result | DiscussionComment |
Um comentário sobre uma discussão. |
CommentResponse
Objeto de resposta para Comment.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Comments
|
comments | array of DiscussionComment |
Comentários nesta discussão. |