Users Files, General

ファイルを post 送信すると、[ファイル] タブに非公開ファイルとしてアップロードされ、ファイル所有者のみが使用できるようになります。

ファイルをアップロードするには、マルチパート/フォームデータ要求で送信する必要があります。ファイルの説明とタイトルをマルチパート/フォームデー���要求に JSON または XML リクエストボディとして含めることができます。情報を要求パラメータとして送信することもできます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。

リソース

1/chatter/users/userId/files

1/connect/communities/communityId/chatter/users/userId/files

適用開始バージョン

24.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、POST、または HEAD

POST のリクエストボディ

このリクエストボディでは、新しいファイル入力について説明します。ファイルをアップロードするには、name="fileData" のマルチパート/フォームデータボディパートにそのバイナリファイルを含める必要があります。「バイナリファイルのアップロード」を参照してください。

ルート XML タグ

<fileInput>

JSON

1{ 
2   "desc":"Employee Survey Results",
3   "title":"emp_surv_results"
4}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
content​ModifiedDate	Date	ファイル固有の最終更新日。クライアント側の更新日を設定するために使用できます。	省略可能	32.0
desc	String	アップロードするファイルの説明。	省略可能	24.0
includeExternal​FilePerimissions​Info	Boolean	ファイルを共有するかどうか、外部ファイルに対して使用可能���権限タイプなどの、権限情報を含めるかどうかを示します。 このプロパティは、/chatter/users/userId/files に対する POST 要求では使用できますが、/chatter/files/fileId に対する POST 要求では使用できません。	省略可能	35.0
isInMyFileSync	Boolean	ファイルが Salesforce Files Sync と同期されている場合は true、同期されていない場合は false。	省略可能	31.0
isMajorVersion	Boolean	ファイルがメジャーバージョンの場合は true、ファイルがマイナーバージョンの場合は false。メジャーバージョンを置き換えることはできません。	省略可能	31.0
parentFolderId	String	収容フォルダの ID。	省略可能	31.0
repository​FileId	String	外部ファイルの ID。	省略可能	32.0
repositoryId	String	外部データソースの ID。	省略可能	32.0
sharingOption	String	ファイルの共有オプション。値は次のとおりです。 Allowed — ファイルの再共有が許可されます。 Restricted — ファイルの再共有が禁止されます。	省略可能	35.0
title	String	ファイルのタイトル。	省略可能	24.0

POST の要求パラメータ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
content​ModifiedDate	Date	ファイル固有の最終更新日。クライアント側の更新日を設定するために使用できます。	省略可能	32.0
desc	String	ファイルの説明	省略可能	24.0
includeExternal​FilePerimissions​Info	Boolean	ファイルを共有するかどうか、外部ファイルに対して使用可能な権限タイプなどの、権限情報を含めるかどうかを示します。	省略可能	35.0
isDataSync	Boolean	要求は自動クライアントによって自動生成されます。	省略可能	31.0
isInMyFileSync	Boolean	ファイルが Salesforce Files Sync と同期されている場合は true、同期されていない場合は false。デフォルト値は、false です。	省略可能	31.0
isMajorVersion	Boolean	ファイルがメジャーバージョンの場合は true、ファイルがマイナーバージョンの場合は false。メジャーバージョンを置き換えることはできません。デフォルト値は、false です。	省略可能	31.0
repository​FileId	String	外部ファイルの ID。	省略可能	32.0
repositoryId	String	外部データソースの ID。	省略可能	32.0
sharingOption	String	ファイルの共有オプション。値は次のとおりです。 Allowed — ファイルの再共有が許可されます。 Restricted — ファイルの再共有が禁止されます。	省略可能	35.0
title	String	ファイルのタイトル	省略可能	24.0

GET の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
page	Integer	項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。	24.0
pageSize	Integer	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。	24.0
q	String	結果を絞り込むクエリ文字列。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。	27.0

GET のレスポンスボディ

File Summary Page

POST のレスポンスボディ

File Summary

POST 要求の例

次の例では、新しいファイルを作成し、Salesforce Files Sync にアップロードします。この例は、マルチパート/フォームデータ要求のボディパートを示します。最初のボディパートは File Input リクエストボディです。2 つ目は、ファイルのコンテンツです。詳細は、「バイナリファイルのアップロード」 を参照してください。

1POST /services/data/v35.0/chatter/users/me/files
2
3Authorization: OAuth 00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA.
4OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyae
5User-Agent: Jakarta Commons-HttpClient/3.0.1
6Host: instance_name
7Content-Length: 489
8Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
9Accept: application/json
10
11--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
12Content-Type: application/json; charset=UTF-8
13Content-Disposition: form-data; name="json"
14
15{
16   "title":"BoatPrices"
17}
18
19--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq
20Content-Disposition: form-data; name="fileData"; filename="BoatPrices.txt"
21Content-Type: application/octet-stream; charset=ISO-8859-1
22
23...contents of BoatPrices.txt...
24
25--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq--