Zum Hauptinhalt springen
POST
/
files
/
v3
/
files
/
import-from-url
/
async
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"
    }
  ]
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -Starter
この API には、次のいずれかのスコープが必要です。
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：ファイルはURLを知っていれば誰でもアクセスできます。検索エンジンはファイルをインデックスできます。PUBLIC_NOT_INDEXABLE：ファイルはURLを知っていれば誰でもアクセスできます。検索エンジンはファイルをインデックス「できません」。PRIVATE：ファイルは公開アクセスできません。コンテンツを表示するには、署名付きURLが必要です。検索エンジンはファイルをインデックス「できません」。

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

新しいファイルのダウンロード元のURL。

​
folderPath
string

folderPathまたはfolderIdのいずれかが必要です。アップロードしたファイルの宛先フォルダーパス。フォルダーパスが存在しない場合、フォルダーパスの作成が試みられます。

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL：アカウント全体で重複ファイルを検索します。EXACT_FOLDER：指定されたフォルダー内で重複ファイルを検索します。

Available options:
ENTIRE_PORTAL,
EXACT_FOLDER
​
name
string

ファイルマネージャーにおいて生成されたファイルに付ける名前。

​
duplicateValidationStrategy
enum<string>

NONE：重複の検証は実行されません。REJECT：重複が見つかった場合はアップロードが拒否されます。RETURN_EXISTING：重複ファイルが見つかった場合、新しいファイルはアップロードされず、見つかった重複が返されます。

Available options:
NONE,
REJECT,
RETURN_EXISTING
​
ttl
string

公開までの時間。指定した場合、ファイルは指定した期間を過ぎると削除されます。未設定のままにすると、ファイルは無期限で残ります。

​
overwrite
boolean

trueの場合、指定されたフォルダーに同じ名前と拡張子のファイルがあると、既存のファイルが上書きされます。上書きされたファイルは削除され、代わりにアップロードしたファイルが新しいIDで残ります。設定しなかったかfalseとして設定した場合、同じパス、名前、拡張子のファイルがあると、既存のファイルと競合しないように新しいファイルの名前が更新されます

​
expiresAt
string<date-time>

ファイルの有効期限が切れる日時を指定します。

​
folderId
string

folderIdまたはfolderPathのいずれかが必要です。アップロードしたファイルの宛先folderId。

Response

accepted

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

​
links
object
required

タスクに関連する情報をチェックする場所のリンク。「status」リンクにより、タスクのステータスを確認する場所のURLが指定されます。

Example:

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

​
id
string
required

タスクのID

Example:

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

⌘I