Zum Hauptinhalt springen
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Importar arquivo do URL
curl --request POST \
  --url https://api.hubapi.com/files/v3/files/import-from-url/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "folderPath": "<string>",
  "access": "PUBLIC_INDEXABLE",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "name": "<string>",
  "duplicateValidationStrategy": "NONE",
  "ttl": "<string>",
  "overwrite": true,
  "expiresAt": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "folderId": "<string>"
}'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/files/import-from-url/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}
Produtos suportados
Requer um dos seguintes produtos ou superior.
Marketing HubMarketing HubGrátis
Sales HubSales HubGrátis
Service HubService HubGrátis
Content HubContent HubStarter

​
Escopos Necessários

Esta API requer um dos seguintes escopos:
  • files

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
access
enum<string>
required

PUBLIC_INDEXABLE: o arquivo pode ser acessado por qualquer pessoa que tenha o URL. Os mecanismos de pesquisa podem indexar o arquivo. PUBLIC_NOT_INDEXABLE: o arquivo pode ser acessado por qualquer pessoa que tenha o URL. Os mecanismos de pesquisa não podem indexar o arquivo. PRIVATE: o arquivo NÃO pode ser acessado por qualquer pessoa. Exige um URL assinado para ver o conteúdo. Os mecanismos de pesquisa não podem indexar o arquivo.

Available options:
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
PRIVATE,
HIDDEN_SENSITIVE,
SENSITIVE
​
url
string
required

O URL do qual baixar o novo arquivo.

​
folderPath
string

É necessário fornecer folderPath ou folderId. O caminho da pasta de destino para o arquivo carregado. Se o caminho da pasta não existir, tentaremos criá-lo.

​
duplicateValidationScope
enum<string>

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

Available options:
ENTIRE_PORTAL,
EXACT_FOLDER
​
name
string

O nome a ser fornecido ao arquivo resultante no gerenciador de arquivos.

​
duplicateValidationStrategy
enum<string>

NONE: não executar nenhuma validação duplicada. REJECT: rejeitar o upload se for encontrado um objeto duplicado. RETURN_EXISTING: se for encontrado um arquivo duplicado, não fazer upload de um novo arquivo e retornar o arquivo duplicado encontrado.

Available options:
NONE,
REJECT,
RETURN_EXISTING
​
ttl
string

O tempo de vida. Se especificado, o arquivo será excluído após o período de tempo fornecido. Se deixado em branco, o arquivo existirá indefinidamente.

​
overwrite
boolean

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

​
expiresAt
string<date-time>

Especifica a data e a hora em que o arquivo irá expirar.

​
folderId
string

É necessário fornecer folderId ou folderPath. O folderId de destino para o arquivo carregado.

Response

accepted

Information on the task that has been started, and where to check it's status.

​
links
object
required

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

Example:

"[{\"status\":\"https://api.hubspot.com/files/v3/files/import-from-url/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status\"}]"

​
id
string
required

ID da tarefa

Example:

"57122e26-59f8-4cfc-ba53-96e30c816762"

⌘I