Compartilhar via


Arquivos HubSpot V2 (Editor Independente) (versão prévia)

Com o CRM hubSpot fácil de usar, você nunca precisará atualizar manualmente os relatórios ou se perguntar como sua equipe está acompanhando as cotas. Obtenha uma exibição em tempo real de todo o pipeline de vendas em um painel visual. O HubSpot CRM organizará, enriquecerá e acompanhará automaticamente cada contato em uma linha do tempo organizada.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – 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 Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadados do conector
Publicador Troy Taylor
Site da Web https://www.hubspot.com/
Política de privacidade https://legal.hubspot.com/privacy-policy
Categorias Conteúdo e arquivos; Vendas e CRM

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Token de acesso (no formato 'Bearer YOUR_TOKEN') secureString O Token de Acesso (no formato 'Bearer YOUR_TOKEN') para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Atualizar arquivo

Substitui dados de arquivo existentes por novos dados de arquivo. Pode ser usado para alterar o conteúdo da imagem sem precisar carregar um novo arquivo e atualizar todas as referências.

Atualizar propriedades da pasta

Atualize as propriedades da pasta por determinada ID. Essa ação ocorre de forma assíncrona e também atualizará todos os filhos da pasta.

Atualizar propriedades do arquivo

Atualize as propriedades do arquivo por ID.

Carregar ficheiro

Carregue um único arquivo com o conteúdo especificado no corpo da solicitação.

Criar uma pasta

Cria uma pasta.

Excluir arquivo

Excluir arquivo por ID.

Excluir arquivo para GDRP

Exclui um arquivo para GDRP.

Excluir pasta

Excluir pasta por ID.

Gerar link

Gera a URL assinada que permite acesso temporário a um arquivo privado.

Importar arquivo de forma assíncrona

Importa de forma assíncrona o arquivo na URL fornecida para o gerenciador de arquivos.

Obter arquivo

Recupere um arquivo por ID.

Obter arquivo por caminho

Recupere o arquivo pelo endereço do caminho.

Obter pasta

Obter pasta por ID.

Pastas de pesquisa

Pesquise pastas. Não contém pastas ocultas ou arquivadas.

Pesquisar arquivos

Pesquise arquivos no gerenciador de arquivos. Não exibe arquivos ocultos ou arquivados.

Verificar atualização de pasta

Verifique o status da atualização da pasta. As atualizações de pasta ocorrem de forma assíncrona.

Verificar o status de importação

Verifique o status da importação solicitada.

Atualizar arquivo

Substitui dados de arquivo existentes por novos dados de arquivo. Pode ser usado para alterar o conteúdo da imagem sem precisar carregar um novo arquivo e atualizar todas as referências.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

ID do arquivo desejado.

File
file file

Dados de arquivo que substituirão o arquivo existente no gerenciador de arquivos.

Conjunto de caracteres
charsetHunch string

Conjunto de caracteres de dados de arquivo especificados.

Opções
options string

Cadeia de caracteres JSON que representa FileReplaceOptions.

Retornos

Arquivo.

File
File

Atualizar propriedades da pasta

Atualize as propriedades da pasta por determinada ID. Essa ação ocorre de forma assíncrona e também atualizará todos os filhos da pasta.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da pasta pai
parentFolderId integer

Nova folderId pai. Se alterada, a pasta e todos os filhos serão movidos para a pasta especificada. parentFolderId e parentFolderPath não podem ser especificados ao mesmo tempo.

Nome
name string

Novo nome. Se especificado o nome da pasta e fullPath será alterado. Todos os filhos da pasta serão atualizados adequadamente.

ID
id True string

ID da pasta a ser alterada.

Retornos

Informações sobre a tarefa iniciada e onde verificar seu status.

FolderUpdateTaskLocator
FolderUpdateTaskLocator

Atualizar propriedades do arquivo

Atualize as propriedades do arquivo por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

ID do arquivo a ser atualizado.

Access2
access string

NONE: Não execute nenhuma validação duplicada. REJECT: rejeite o upload se uma duplicata for encontrada. RETURN_EXISTING: se um arquivo duplicado for encontrado, não carregue um novo arquivo e retorne a duplicata encontrada.

ID da pasta pai
parentFolderId string

FolderId para onde o arquivo deve ser movido. Os parâmetros folderId e folderPath não podem ser definidos ao mesmo tempo.

Nome
name string

Novo nome para o arquivo.

Caminho da pasta pai
parentFolderPath string

Caminho da pasta para o qual o arquivo deve ser movido. Os parâmetros folderId e folderPath não podem ser definidos ao mesmo tempo.

É utilizável no contexto
isUsableInContent boolean

Marque se o arquivo deve ser usado em novo conteúdo ou não.

Expira em
expiresAt integer

Quando expirar em.

Retornos

Arquivo.

File
File

Carregar ficheiro

Carregue um único arquivo com o conteúdo especificado no corpo da solicitação.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
file True file

Arquivo a ser carregado.

ID da pasta
folderId string

'folderId' ou 'folderPath' é necessário. folderId é a ID da pasta na qual o arquivo será carregado.

Caminho da pasta
folderPath string

'folderPath' ou 'folderId' é necessário. Esse campo representa o caminho da pasta de destino para o arquivo carregado. Se um caminho não existir, o sistema tentará criar um.

Nome do Arquivo
fileName True string

Nome desejado para o arquivo carregado.

Conjunto de caracteres
charsetHunch string

Conjunto de caracteres do arquivo carregado.

Opções de Acesso
options.access True string

Nível de acesso para o arquivo carregado.

Opções de TTL
options.ttl integer

Tempo de vida útil para o arquivo carregado.

Retornos

Arquivo.

File
File

Criar uma pasta

Cria uma pasta.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da pasta pai
parentFolderId string

FolderId do pai da pasta criada. Se não for especificado, a pasta será criada no nível raiz. parentFolderId e parentFolderPath não podem ser definidos ao mesmo tempo.

Caminho pai
parentPath string

Caminho do pai da pasta criada. Se não for especificado, a pasta será criada no nível raiz. parentFolderPath e parentFolderId não podem ser definidos ao mesmo tempo.

Nome
name True string

Nome desejado para a pasta.

Retornos

Pasta
Folder

Excluir arquivo

Excluir arquivo por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

FileId a ser excluído.

Excluir arquivo para GDRP

Exclui um arquivo para GDRP.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

ID do arquivo para exclusão de RGPD.

Excluir pasta

Excluir pasta por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da pasta
folderId True string

ID da pasta a ser excluída.

Gera a URL assinada que permite acesso temporário a um arquivo privado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

ID do arquivo.

Tamanho
size string

Para arquivos de imagem. Isso redimensionará a imagem para o tamanho desejado antes do compartilhamento. Não afeta o arquivo original, apenas o arquivo atendido por essa URL assinada.

Vencimento
expirationSeconds integer

Quanto tempo em segundos o link fornecerá acesso ao arquivo.

Upscale
upscale boolean

Se o tamanho for fornecido, isso aumentará o dimensionamento da imagem para se ajustar às dimensões de tamanho.

Retornos

Objeto url assinado com metadados auxiliares opcionais do arquivo solicitado.

SignedUrl
SignedUrl

Importar arquivo de forma assíncrona

Importa de forma assíncrona o arquivo na URL fornecida para o gerenciador de arquivos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho da pasta
folderPath string

Um dos folderPath ou folderId é necessário. Caminho da pasta de destino para o arquivo carregado. Se o caminho da pasta não existir, haverá uma tentativa de criar o caminho da pasta.

Access1
access True string

PUBLIC_INDEXABLE: o arquivo é publicamente acessível por qualquer pessoa que tenha a URL. Os mecanismos de pesquisa podem indexar o arquivo. PUBLIC_NOT_INDEXABLE: o arquivo é publicamente acessível por qualquer pessoa que tenha a URL. Os mecanismos de pesquisa não podem indexar o arquivo. PRIVADO: O arquivo NÃO é acessível publicamente. Requer uma URL assinada para ver o conteúdo. Os mecanismos de pesquisa não podem indexar o arquivo.

DuplicateValidationScope
duplicateValidationScope string

ENTIRE_PORTAL: procure um arquivo duplicado em toda a conta. EXACT_FOLDER: procure um arquivo duplicado na pasta fornecida.

Nome
name string

Nome para dar o arquivo resultante no gerenciador de arquivos.

DuplicateValidationStrategy
duplicateValidationStrategy string

NONE: Não execute nenhuma validação duplicada. REJECT: rejeite o upload se uma duplicata for encontrada. RETURN_EXISTING: se um arquivo duplicado for encontrado, não carregue um novo arquivo e retorne a duplicata encontrada.

TTL
ttl string

Hora de viver. Se especificado, o arquivo será excluído após o período determinado. Se não for definido, o arquivo existirá indefinidamente.

Sobrescrever
overwrite boolean

Se for true, substituirá o arquivo existente se houver um com o mesmo nome e extensão na pasta fornecida. O arquivo substituído será excluído e o arquivo carregado tomará seu lugar com uma nova ID. Se não estiver definido ou definido como false, o nome do novo arquivo será atualizado para evitar a colisão com o arquivo existente se houver um com o mesmo caminho, nome e extensão

URL
url True string

URL da qual baixar o novo arquivo.

ID da pasta
folderId string

Um dos folderId ou folderPath é necessário. FolderId de destino para o arquivo carregado.

Retornos

Informações sobre a tarefa iniciada e onde verificar seu status.

ImportFromUrlTaskLocator
ImportFromUrlTaskLocator

Obter arquivo

Recupere um arquivo por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de Arquivo
fileId True string

ID do arquivo desejado.

Propriedades
properties string

As propriedades.

Retornos

Arquivo.

File
File

Obter arquivo por caminho

Recupere o arquivo pelo endereço do caminho.

Parâmetros

Nome Chave Obrigatório Tipo Description
Caminho
path True string

O caminho.

Propriedades
properties array

As propriedades.

Retornos

FileStat
FileStat

Obter pasta

Obter pasta por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da pasta
folderId True string

ID da pasta desejada.

Propriedades
properties array

Propriedades a serem definidas na pasta retornada.

Retornos

Pasta
Folder

Pastas de pesquisa

Pesquise pastas. Não contém pastas ocultas ou arquivadas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Propriedades
properties array

Propriedades que devem ser incluídas nas pastas retornadas.

Após
after string

O deslocamento máximo de itens para uma determinada pesquisa é de 10000. Reduza sua pesquisa se você estiver atingindo esse limite.

Antes
before string

O anterior.

Limit
limit integer

Limite de resultados a serem retornados. O limite máximo é de 100.

Classificar
sort array

Classificar os resultados por determinada propriedade. Por exemplo, -name classificações por campo de nome decrescente, nome classifica por campo de nome crescente.

ID
id string

Pesquisar pasta por determinada ID.

Criado em
createdAt string

Pesquise pastas com o carimbo de data/hora de criação fornecido.

Criado no LTE
createdAtLte string

O criado em tempo menor ou igual.

Criado no GTE
createdAtGte string

O criado em maior ou igual.

Atualizado em
updatedAt string

Pesquise pasta em determinado carimbo de data/hora de atualização.

Atualizado no LTE
updatedAtLte string

A atualização posterior ou igual.

Atualizado no GTE
updatedAtGte string

O atualizado em maior ou igual.

Nome
name string

Pesquise pastas que contenham o nome especificado.

Caminho
path string

Pesquise pastas por caminho.

ID da pasta pai
parentFolderId integer

Pesquise pastas com a folderId pai fornecida.

Retornos

CollectionResponseFolder
CollectionResponseFolder

Pesquisar arquivos

Pesquise arquivos no gerenciador de arquivos. Não exibe arquivos ocultos ou arquivados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Propriedades
properties array

Propriedades de arquivo desejadas no objeto de retorno.

Após
after string

O deslocamento máximo de itens para uma determinada pesquisa é de 10000. Reduza sua pesquisa se você estiver atingindo esse limite.

Antes
before string

O anterior.

Limit
limit integer

Número de itens a serem retornados. O limite máximo é 100.

Classificar
sort array

Classificar arquivos por um determinado campo.

ID
id string

Pesquise arquivos por determinada ID.

Criado em
createdAt string

Pesquise arquivos por hora de criação.

Criado no LTE
createdAtLte string

O criado em tempo menor ou igual.

Criado no GTE
createdAtGte string

O criado em maior ou igual.

Atualizado em
updatedAt string

Pesquisar arquivos por hora da atualização mais recente.

Atualizado no LTE
updatedAtLte string

A atualização posterior ou igual.

Atualizado no GTE
updatedAtGte string

O atualizado em maior ou igual.

Nome
name string

Pesquise arquivos que contenham o nome fornecido.

Caminho
path string

Pesquisar arquivos por caminho.

ID da pasta pai
parentFolderId integer

Pesquisar arquivos em determinada folderId.

Tamanho
size integer

Consulta por tamanho de arquivo.

Altura
height integer

Pesquisar arquivos por altura de imagem ou vídeo.

Largura
width integer

Pesquisar arquivos por largura de imagem ou vídeo.

Codificação
encoding string

Pesquisar arquivos com codificação especificada.

Tipo
type string

Filtrar por tipo de arquivo fornecido.

Extension
extension string

Pesquisar arquivos por determinada extensão.

URL
url string

Pesquise por determinada URL.

É utilizável no conteúdo
isUsableInContent boolean

Se true mostrar arquivos que foram marcados para serem usados em novo conteúdo. Ele falso mostra arquivos que não devem ser usados em novo conteúdo.

Permitir acesso anônimo
allowsAnonymousAccess boolean

Se 'true' mostrará arquivos privados; se 'false' mostrará arquivos públicos.

Retornos

Coleções de arquivos.

CollectionResponseFile
CollectionResponseFile

Verificar atualização de pasta

Verifique o status da atualização da pasta. As atualizações de pasta ocorrem de forma assíncrona.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

TaskId da atualização de pasta.

Retornos

FolderActionResponse
FolderActionResponse

Verificar o status de importação

Verifique o status da importação solicitada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

Importar por ID da tarefa de URL.

Retornos

FileActionResponse
FileActionResponse

Definições

StandardError

Nome Caminho Tipo Description
Subcategoria
subCategory object

A subcategoria.

Contexto
context object

O contexto.

Links
links object

Os links.

ID
id string

O identificador.

Categoria
category string

A categoria.

Message
message string

A mensagem.

Errors
errors array of ErrorDetail

Os erros.

Situação
status string

O status.

FolderActionResponse

Nome Caminho Tipo Description
Pasta
result Folder
Concluído em
completedAt string

Quando as alterações solicitadas tiverem sido concluídas.

Número de erros
numErrors integer

Número de erros resultantes das alterações solicitadas.

Solicitado em
requestedAt string

Carimbo de data/hora que representa quando a tarefa foi solicitada.

Iniciado em
startedAt string

Carimbo de data/hora que representa quando a tarefa foi iniciada.

Links
links object

Link para verificar o status da tarefa.

Errors
errors array of StandardError

Erros detalhados resultantes da tarefa.

ID da tarefa
taskId string

ID da tarefa.

Situação
status Status

Status atual da tarefa.

Paging

Nome Caminho Tipo Description
NextPage
next NextPage
PreviousPage
prev PreviousPage

Pasta

Nome Caminho Tipo Description
Criado em
createdAt string

Carimbo de data/hora da criação da pasta.

Arquivado em
archivedAt string

Carimbo de data/hora da exclusão de pasta.

Arquivados
archived boolean

Marca se a pasta é excluída ou não.

Caminho
path string

Caminho da pasta no gerenciador de arquivos.

ID da pasta pai
parentFolderId string

ID da pasta pai.

Nome
name string

Nome da pasta.

ID
id string

ID da pasta .

Atualizado em
updatedAt string

Carimbo de data/hora da atualização mais recente para a pasta.

CollectionResponseFile

Coleções de arquivos.

Nome Caminho Tipo Description
Paging
paging Paging
results
results array of File

Detalhe do erro

Nome Caminho Tipo Description
Subcategoria
subCategory string

Uma categoria específica que contém detalhes mais específicos sobre o erro.

Code
code string

O código de status associado aos detalhes do erro.

Description
in string

O nome do campo ou parâmetro no qual o erro foi encontrado.

Contexto
context object

Contexto sobre a condição de erro.

Message
message string

Uma mensagem legível humana que descreve o erro junto com as etapas de correção, quando apropriado.

FileActionResponse

Nome Caminho Tipo Description
File
result File

Arquivo.

Concluído em
completedAt string

Hora da conclusão da tarefa.

Número de erros
numErrors integer

Número de erros resultantes da tarefa.

Solicitado em
requestedAt string

Carimbo de data/hora de quando a tarefa foi solicitada.

Iniciado em
startedAt string

Carimbo de data/hora de quando a tarefa foi iniciada.

Links
links object

Link para verificar o status da tarefa solicitada.

Errors
errors array of StandardError

Mensagens de erro descritivas.

ID da tarefa
taskId string

ID da tarefa solicitada.

Situação
status Status

Status atual da tarefa.

CollectionResponseFolder

Nome Caminho Tipo Description
Paging
paging Paging
results
results array of Folder

FileStat

Nome Caminho Tipo Description
File
file File

Arquivo.

Pasta
folder Folder

SignedUrl

Objeto url assinado com metadados auxiliares opcionais do arquivo solicitado.

Nome Caminho Tipo Description
Extension
extension string

Extensão do arquivo solicitado.

Tamanho
size integer

Tamanho em bytes do arquivo solicitado.

Nome
name string

Nome do arquivo solicitado.

Largura
width integer

Para arquivos de imagem e vídeo. A largura do arquivo.

Tipo
type string

Tipo do arquivo. Pode ser IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

Expira em
expiresAt string

Carimbo de data/hora de quando a URL não concederá mais acesso ao arquivo.

URL
url string

URL assinada com acesso ao arquivo especificado. Qualquer pessoa com essa URL poderá acessar o arquivo até que ele expire.

Altura
height integer

Para arquivos de imagem e vídeo. A altura do arquivo.

PreviousPage

Nome Caminho Tipo Description
Antes
before string

O anterior.

Link
link string

O link.

ImportFromUrlTaskLocator

Informações sobre a tarefa iniciada e onde verificar seu status.

Nome Caminho Tipo Description
Links
links object

Links para onde verificar informações relacionadas à tarefa. O status link fornece a URL para onde verificar o status da tarefa.

ID
id string

ID da tarefa.

File

Arquivo.

Nome Caminho Tipo Description
Extension
extension string

Extensão do arquivo. ex: .jpg, .png, .gif, .pdfetc.

Acesso
access Access

Acesso a arquivos. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

ID da pasta pai
parentFolderId string

ID da pasta em que o arquivo está.

Codificação
encoding string

Codificação do arquivo.

Tipo
type string

Tipo do arquivo. Pode ser IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

É utilizável no contexto
isUsableInContent boolean

Anteriormente "arquivado". Indica se o arquivo deve ser usado ao criar um novo conteúdo, como páginas da Web.

URL
url string

URL do arquivo especificado. Essa URL pode ser alterada dependendo das configurações de domínio da conta. Usará o domínio de hospedagem de arquivo selecionado.

Expira em
expiresAt integer

Quando expirar em.

Criado em
createdAt string

Hora de criação do objeto de arquivo.

Arquivado em
archivedAt string

Hora de exclusão do objeto de arquivo.

Arquivados
archived boolean

Se o arquivo for excluído.

Caminho
path string

Caminho do arquivo no gerenciador de arquivos.

Tamanho
size integer

Tamanho do arquivo em bytes.

Nome
name string

Nome do arquivo.

Largura
width integer

Para arquivos de imagem e vídeo, a largura do conteúdo.

ID
id string

ID do arquivo.

URL de Hospedagem Padrão
defaultHostingUrl string

URL de hospedagem padrão do arquivo. Isso usará uma das URLs fornecidas do HubSpot para atender ao arquivo.

Atualizado em
updatedAt string

Carimbo de data/hora da atualização mais recente para o arquivo.

Altura
height integer

Para arquivos de imagem e vídeo, a altura do conteúdo.

NextPage

Nome Caminho Tipo Description
Link
link string

O link.

Após
after string

O depois.

FolderUpdateTaskLocator

Informações sobre a tarefa iniciada e onde verificar seu status.

Nome Caminho Tipo Description
Links
links object

Links para onde verificar informações relacionadas à tarefa. O status link fornece a URL para onde verificar o status da tarefa.

ID
id string

ID da tarefa.

Acesso

Acesso a arquivos. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

Acesso a arquivos. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

Acesso
string

Situação

Status atual da tarefa.

Status atual da tarefa.

Situação
string