Zum Hauptinhalt springen
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Datei von URL importieren
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"
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Starter
Diese API erfordert einen der folgenden Bereiche:
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: Datei ist für alle, die die URL aufrufen, öffentlich zugänglich. Suchmaschinen können die Datei indexieren. PUBLIC_NOT_INDEXABLE: Datei ist für alle, die die URL aufrufen, öffentlich zugänglich. Suchmaschinen können die Datei nicht indexieren. PRIVATE: Datei ist NICHT öffentlich zugänglich. Signierte URL erforderlich, um den Inhalt zu sehen. Suchmaschinen können die Datei nicht indexieren.

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

URL, über die die neue Datei heruntergeladen werden soll.

​
folderPath
string

Entweder „folderPath“ oder „folderId“ erforderlich. Zielordnerpfad für die hochgeladene Datei. Wenn der Ordnerpfad nicht vorhanden ist, wird versucht, den Ordnerpfad zu erstellen.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL: Suche nach einer doppelten Datei im gesamten Account. EXACT_FOLDER: Suche nach einer doppelten Datei im angegebenen Ordner.

Available options:
ENTIRE_PORTAL,
EXACT_FOLDER
​
name
string

Name für die Ergebnisdatei im Datei-Manager.

​
duplicateValidationStrategy
enum<string>

NONE: Es wird keine doppelte Validierung durchgeführt. REJECT: Der Upload wird verworfen, wenn eine doppelte Datei gefunden wurde. RETURN_EXISTING: Wenn eine doppelte Datei gefunden wurde, keine neue Datei hochladen, sondern stattdessen das gefunden Duplikat zurückgeben.

Available options:
NONE,
REJECT,
RETURN_EXISTING
​
ttl
string

„Time to Live“. Sofern angegeben, wird die Datei nach der angegebenen Zeitspanne gelöscht. Ohne Angabe bleibt die Datei unbegrenzt bestehen.

​
overwrite
boolean

„true“ (wahr) verweist darauf, dass eine vorhandene Datei überschrieben wird, wenn eine Datei mit demselben Namen und derselben Erweiterung im angegebenen Ordner vorhanden ist. Die überschriebene Datei wird gelöscht und durch die hochgeladene Datei ersetzt. Diese erhält eine neue ID. Sofern nicht festgelegt oder „false“ (falsch), wird der Name der neuen Datei aktualisiert, um Konflikte mit vorhandenen Dateien zu vermeiden, falls eine solche mit demselben Pfad, demselben Namen und derselben Erweiterung vorhanden ist.

​
expiresAt
string<date-time>

Gibt den Zeitpunkt (Datum und Uhrzeit) an, an dem die Datei abläuft.

​
folderId
string

„folderId“ oder „folderPath“ ist erforderlich. Zielordner-folderId für die hochgeladene Datei.

Response

accepted

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

​
links
object
required

Links zum Abrufen von Informationen, die sich auf die Aufgabe beziehen. Der „Status“-Link enthält die URL, unter der der Status der Aufgabe angezeigt werden kann.

Example:

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

​
id
string
required

ID der Aufgabe

Example:

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

⌘I