ファイルのアップロード

外部システムにファイルデータをアップロードし、レスポンスオブジェクトを返します。このカードはマルチパートアップロードをサポートします。

この関数カードはConnector Builderでのみ使用可能です。

入力

フィールド 定義 タイプ 必須
File Content（ファイルコンテンツ） アップロードするファイルコンテンツ。 ファイル TRUE
URL リクエストのURL（http://またはhttps://のプロトコルを含む）。 文字列 TRUE
HTTP Method（HTTPメソッド）

使用するHTTPメソッド：

  • POST

  • PUT

ドロップダウン TRUE
Protocol（プロトコル）

使用するプロトコル：

  • HTTP

  • SFTP

ドロップダウン TRUE
Query（クエリ）

キーと値のペアとして含める追加のクエリパラメーターを指定します。

例：{"name":"something-urgent"}は、クエリパラメーター?name=something-urgent&...に変換されます。

 オブジェクト FALSE
Headers（ヘッダー） リクエストに対するヘッダーを指定します。 オブジェクト FALSE
File Metadata（ファイルメタデータ）

この入力は、マルチパートアップロードに使用されます。ファイルコンテンツとともに送信する追加のプロパティが含まれています。統合でファイルリクエスト本文のプロパティに順序が必要な場合、この入力は最初の部分を表します。この入力に必要な詳細は、統合によって異なります。

送信できるデータの例には次のものがあります。

  • ファイル名。

  • ファイルの説明。

  • アップロードの場所。

統合でリクエスト本文のヘッダーが必要ない場合は、キー/値ペアの形式を使用します。

データのコンテンツが文字列でない場合は、［JSON Stringify］カードを使用して、このカードで使用するためにコンテンツを文字列に変換できます。

https://ja.developer.box.com/reference/post-files-content/の形式の例：

コピー 
{
    "your_key_name": "content"
}

https://developers.google.com/workspace/drive/api/guides/manage-uploadsのヘッダーを指定する必要がある形式の例：

コピー 
{
    "your_key_name":{
        "headers": object,
        "content": string,
    }
}
 オブジェクト FALSE
File Info（ファイル情報）

このプロパティは、マルチパートアップロードのリクエストに使用されます。［File Metadata（ファイルメタデータ）］の入力を使用する場合、必要になります。この入力には、キー"name"を持つ少なくとも1つのプロパティーが必要です。値は空にできます。この入力に対するその他の詳細は、統合によって異なります。統合でファイルリクエストプロパティに順序が必要な場合、この入力は2つ目のオプションを表します。

送信できるデータの例には次のものがあります。

  • ファイル名。

  • ファイルタイプ。

  • ファイルコンテンツ。

https://ja.developer.box.com/reference/post-files-content/の形式の例：

コピー 
{
    "name": {integration_field_name},
    "params": {
        "filename": "{filename}"
    },
    "headers": object (if required)
}

https://developers.google.com/workspace/drive/api/guides/manage-uploadsの形式の例：

コピー 
{
    "name": {integration_field_name},
    "headers": object (if required)
}
 オブジェクト FALSE

出力

フィールド 定義 タイプ
Status Code（ステータスコード）

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例：

  • 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、「HTTPステータスコード」を参照してください。

 数値
Headers（ヘッダー） 出力ボディーとは関係のない、ステータスコードの詳細なコンテキスト。レスポンスヘッダーは、選択したHTTPリクエストオプションによって決定します。すべてのヘッダーがレスポンスヘッダーというわけではありません。ヘッダーは、{"Content-type":"application/json"}のようになります。 オブジェクト
Body（本文）

選択したHTTPリクエストから返されたデータ。

たとえば、GETリクエストからのデータ。

 テキスト

関連項目

関数

Workflow要素