Partilhar via


HubSpot Files V2 (Independent Publisher) (Visualização)

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

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Troia Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadados do conector
Editora Troia Taylor
Sítio Web https://www.hubspot.com/
Política de privacidade https://legal.hubspot.com/privacy-policy
Categorias Conteúdos e Ficheiros; Vendas e CRM

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 (na forma 'YOUR_TOKEN ao portador') securestring O token de acesso (no formato 'Bearer YOUR_TOKEN') para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Atualizar ficheiro

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

Atualizar propriedades da pasta

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

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 pasta

Cria uma pasta.

Eliminar ficheiro

Excluir arquivo por ID.

Excluir arquivo para GDRP

Exclui um arquivo para GDRP.

Excluir pasta

Excluir pasta por ID.

Gerar link

Gera 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 por caminho

Recupere o arquivo pelo endereço do caminho.

Obter ficheiro

Recupere um arquivo por ID.

Obter pasta

Obter pasta por ID.

Pastas de pesquisa

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

Pesquisar ficheiros

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

Verificar atualização da pasta

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

Verificar o status da importação

Verifique o status da importação solicitada.

Atualizar ficheiro

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

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

ID do ficheiro pretendido.

Ficheiro
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 fornecidos.

Opções
options string

JSON String representando FileReplaceOptions.

Devoluções

Arquivo.

Ficheiro
File

Atualizar propriedades da pasta

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

Parâmetros

Name Chave Necessário Tipo Description
ID da pasta principal
parentFolderId integer

Novo folderId pai. Se alterado, a pasta e todos os seus 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ão alterados. Todos os filhos da pasta serão atualizados de acordo.

ID
id True string

ID da pasta a ser alterada.

Devoluções

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

FolderUpdateTaskLocator
FolderUpdateTaskLocator

Atualizar propriedades do arquivo

Atualize as propriedades do arquivo por ID.

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

ID do ficheiro a atualizar.

Acesso 2
access string

NENHUM: Não execute nenhuma validação duplicada. REJECT: Rejeite o upload se uma duplicata for encontrada. RETURN_EXISTING: Se for encontrado um ficheiro duplicado, não carregue um novo ficheiro e devolva o duplicado encontrado.

ID da pasta principal
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 onde 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 expira em.

Devoluções

Arquivo.

Ficheiro
File

Carregar ficheiro

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

Parâmetros

Name Chave Necessário Tipo Description
Ficheiro
file True file

Ficheiro a carregar.

ID da pasta
folderId string

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

Caminho da pasta
folderPath string

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

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 ficheiro carregado.

Opções TTL
options.ttl integer

Tempo de vida para o arquivo carregado.

Devoluções

Arquivo.

Ficheiro
File

Criar pasta

Cria uma pasta.

Parâmetros

Name Chave Necessário Tipo Description
ID da pasta principal
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.

Devoluções

Folder
Folder

Eliminar ficheiro

Excluir arquivo por ID.

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

FileId para excluir.

Excluir arquivo para GDRP

Exclui um arquivo para GDRP.

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

ID do ficheiro para eliminação do RGPD.

Excluir pasta

Excluir pasta por ID.

Parâmetros

Name Chave Necessário Tipo Description
ID da pasta
folderId True string

ID da pasta a ser excluída.

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

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

ID do ficheiro.

Tamanho
size string

Para arquivos de imagem. Isso redimensionará a imagem para o tamanho desejado antes de compartilhar. Não afeta o ficheiro original, apenas o ficheiro servido por este URL assinado.

Expiração
expirationSeconds integer

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

Escalonamento
upscale boolean

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

Devoluções

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

Name Chave Necessário Tipo Description
Caminho da pasta
folderPath string

É necessário um dos folderPath ou folderId. 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.

Acesso 1
access True string

PUBLIC_INDEXABLE: O ficheiro é acessível publicamente por qualquer pessoa que tenha o URL. Os motores de busca podem indexar o ficheiro. PUBLIC_NOT_INDEXABLE: O ficheiro é acessível publicamente por qualquer pessoa que tenha o URL. Os mecanismos de pesquisa não podem indexar o arquivo. PRIVADO: O arquivo NÃO é acessível publicamente. Requer um URL assinado 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 fornecer o arquivo resultante no gerenciador de arquivos.

DuplicateValidationStrategy
duplicateValidationStrategy string

NENHUM: Não execute nenhuma validação duplicada. REJECT: Rejeite o upload se uma duplicata for encontrada. RETURN_EXISTING: Se for encontrado um ficheiro duplicado, não carregue um novo ficheiro e devolva o duplicado encontrado.

TTL
ttl string

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

Substituir
overwrite boolean

Se verdadeiro, substituirá o arquivo existente se existir um com o mesmo nome e extensão na pasta fornecida. O ficheiro substituído será eliminado e o ficheiro carregado ocupará o seu lugar com um novo ID. Se não for definido ou definido como falso, o nome do novo arquivo será atualizado para evitar colisão com o arquivo existente se existir um com o mesmo caminho, nome e extensão

URL
url True string

URL para transferir o novo ficheiro.

ID da pasta
folderId string

É necessário um dos folderId ou folderPath. FolderId de destino para o arquivo carregado.

Devoluções

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

ImportFromUrlTaskLocator
ImportFromUrlTaskLocator

Obter arquivo por caminho

Recupere o arquivo pelo endereço do caminho.

Parâmetros

Name Chave Necessário Tipo Description
Caminho
path True string

O caminho.

Propriedades
properties array

As propriedades.

Devoluções

FileStat
FileStat

Obter ficheiro

Recupere um arquivo por ID.

Parâmetros

Name Chave Necessário Tipo Description
ID do ficheiro
fileId True string

ID do ficheiro pretendido.

Propriedades
properties string

As propriedades.

Devoluções

Arquivo.

Ficheiro
File

Obter pasta

Obter pasta por ID.

Parâmetros

Name Chave Necessário Tipo Description
ID da pasta
folderId True string

ID da pasta desejada.

Propriedades
properties array

Propriedades a serem definidas na pasta retornada.

Devoluções

Folder
Folder

Pastas de pesquisa

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

Parâmetros

Name Chave Necessário Tipo Description
Propriedades
properties array

Propriedades que devem ser incluídas nas pastas retornadas.

Depois
after string

O deslocamento máximo de itens para uma determinada pesquisa é 10000. Restrinja a sua pesquisa se estiver a atingir este limite.

Antes
before string

O antes.

Limite
limit integer

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

Ordenar
sort array

Classifique os resultados por determinada propriedade. Por exemplo, -name classifica por campo de nome decrescente, nome classifica por campo de nome ascendente.

ID
id string

Pasta de pesquisa por ID fornecido.

Criado em
createdAt string

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

Criado em LTE
createdAtLte string

O criado no tempo menor ou igual.

Criado na GTE
createdAtGte string

O criado em maior que ou igual.

Atualizado em
updatedAt string

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

Atualizado em LTE
updatedAtLte string

O atualizado em mais tarde ou igual.

Atualizado no GTE
updatedAtGte string

O atualizado em maior ou igual.

Nome
name string

Procure pastas que contenham o nome especificado.

Caminho
path string

Procure pastas por caminho.

ID da pasta principal
parentFolderId integer

Procure pastas com o folderId pai fornecido.

Devoluções

CollectionResponseFolder
CollectionResponseFolder

Pesquisar ficheiros

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

Parâmetros

Name Chave Necessário Tipo Description
Propriedades
properties array

Propriedades de arquivo desejadas no objeto de retorno.

Depois
after string

O deslocamento máximo de itens para uma determinada pesquisa é 10000. Restrinja a sua pesquisa se estiver a atingir este limite.

Antes
before string

O antes.

Limite
limit integer

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

Ordenar
sort array

Ordenar ficheiros por um determinado campo.

ID
id string

Pesquise ficheiros por ID determinado.

Criado em
createdAt string

Pesquise ficheiros por altura de criação.

Criado em LTE
createdAtLte string

O criado no tempo menor ou igual.

Criado na GTE
createdAtGte string

O criado em maior que ou igual.

Atualizado em
updatedAt string

Pesquise os ficheiros por altura da última atualização.

Atualizado em LTE
updatedAtLte string

O atualizado em mais tarde ou igual.

Atualizado no GTE
updatedAtGte string

O atualizado em maior ou igual.

Nome
name string

Procure ficheiros que contenham o nome próprio.

Caminho
path string

Pesquise arquivos por caminho.

ID da pasta principal
parentFolderId integer

Pesquise arquivos dentro de determinada folderId.

Tamanho
size integer

Consulta por tamanho de ficheiro.

Altura
height integer

Pesquise ficheiros por altura de imagem ou vídeo.

Largura
width integer

Pesquise ficheiros por largura de imagem ou vídeo.

Codificação
encoding string

Pesquisar arquivos com codificação especificada.

Tipo
type string

Filtre por tipo de arquivo fornecido.

Extension
extension string

Pesquisar arquivos por determinada extensão.

URL
url string

Pesquise um determinado URL.

É utilizável no conteúdo
isUsableInContent boolean

Se true mostra os arquivos que foram marcados para serem usados em novos conteúdos. Ele falso mostra arquivos que não devem ser usados em novos conteúdos.

Permitir acesso anônimo
allowsAnonymousAccess boolean

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

Devoluções

Coleções de arquivos.

CollectionResponseFile
CollectionResponseFile

Verificar atualização da pasta

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

Parâmetros

Name Chave Necessário Tipo Description
ID da tarefa
taskId True string

TaskId da atualização da pasta.

Devoluções

FolderActionResponse
FolderActionResponse

Verificar o status da importação

Verifique o status da importação solicitada.

Parâmetros

Name Chave Necessário Tipo Description
ID da tarefa
taskId True string

Importar por ID de tarefa de URL.

Devoluções

FileActionResponse
FileActionResponse

Definições

Erro padrão

Name Caminho Tipo Description
Subcategoria
subCategory object

A subcategoria.

Context
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

Name Caminho Tipo Description
Folder
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.

Começou 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

Name Caminho Tipo Description
Próxima Página
next NextPage
AnteriorPágina
prev PreviousPage

Folder

Name 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 da pasta.

Arquivado
archived boolean

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

Caminho
path string

Caminho da pasta no gerenciador de arquivos.

ID da pasta principal
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.

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

Detalhes do Erro

Name Caminho Tipo Description
Subcategoria
subCategory string

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

Código
code string

O código de status associado ao detalhe do erro.

Description
in string

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

Context
context object

Contexto sobre a condição de erro.

Message
message string

Uma mensagem legível por humanos descrevendo o erro, juntamente com as etapas de correção, quando apropriado.

FileActionResponse

Name Caminho Tipo Description
Ficheiro
result File

Arquivo.

Concluído em
completedAt string

Tempo de 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.

Começou 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

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

FileStat

Name Caminho Tipo Description
Ficheiro
file File

Arquivo.

Folder
folder Folder

SignedUrl

Objeto Url assinado com metadados auxiliares opcionais do arquivo solicitado.

Name Caminho Tipo Description
Extension
extension string

Extensão do ficheiro solicitado.

Tamanho
size integer

Tamanho em bytes do arquivo solicitado.

Nome
name string

Nome do ficheiro solicitado.

Largura
width integer

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

Tipo
type string

Tipo de arquivo. Pode ser IMG, DOCUMENTO, ÁUDIO, FILME ou OUTRO.

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 esse URL poderá acessar o arquivo até que ele expire.

Altura
height integer

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

AnteriorPágina

Name Caminho Tipo Description
Antes
before string

O antes.

Link
link string

O link.

ImportFromUrlTaskLocator

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

Name Caminho Tipo Description
Links
links object

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

ID
id string

ID da tarefa.

Ficheiro

Arquivo.

Name Caminho Tipo Description
Extension
extension string

Extensão do ficheiro. ex: .jpg, .png, .gif, .pdf, etc.

Access
access Access

Acesso a ficheiros. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVADO.

ID da pasta principal
parentFolderId string

ID da pasta em que o arquivo está.

Codificação
encoding string

Codificação do ficheiro.

Tipo
type string

Tipo de arquivo. Pode ser IMG, DOCUMENTO, ÁUDIO, FILME ou OUTRO.

É utilizável no contexto
isUsableInContent boolean

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

URL
url string

URL do ficheiro fornecido. Este URL pode mudar dependendo das configurações de domínio da conta. Usará o domínio de hospedagem de arquivo selecionado.

Expira em
expiresAt integer

Quando expira em.

Criado em
createdAt string

Tempo de criação do objeto de arquivo.

Arquivado em
archivedAt string

Tempo de exclusão do objeto de arquivo.

Arquivado
archived boolean

Se o ficheiro for eliminado.

Caminho
path string

Caminho do arquivo no gerenciador de arquivos.

Tamanho
size integer

Tamanho do ficheiro em bytes.

Nome
name string

Nome do ficheiro.

Largura
width integer

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

ID
id string

ID do ficheiro.

URL de hospedagem padrão
defaultHostingUrl string

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

Atualizado em
updatedAt string

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

Altura
height integer

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

Próxima Página

Name Caminho Tipo Description
Link
link string

O link.

Depois
after string

O depois.

FolderUpdateTaskLocator

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

Name Caminho Tipo Description
Links
links object

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

ID
id string

ID da tarefa.

Access

Acesso a ficheiros. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVADO.

Acesso a ficheiros. Pode ser PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVADO.

Access
string

Situação

Status atual da tarefa.

Status atual da tarefa.

Situação
string