この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Users Files, General

外部ファイルへの参照を含む、Salesforce Files Sync へのファイルの投稿、またはユーザが所有するファイルに関する情報の取得を行います。ユーザと共有されているファイル、ユーザがフォローしているファイル、一般的な組織ファイルは対象外です。

ファイルを 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}

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`contentModifiedDate`	Date	ファイル固有の最終更新日。クライアント側の更新日を設定するために使用できます。	省略可能	32.0
`desc`	String	アップロードするファイルの説明。	省略可能	24.0
`isInMyFileSync`	Boolean	ファイルが Salesforce Files Sync と同期されている場合は `true`、同期されていない場合は `false`。	省略可能	31.0
`isMajorVersion`	Boolean	ファイルがメジャーバージョンの場合は `true`、ファイルがマイナーバージョンの場合は `false`。メジャーバージョンを置き換えることはできません。	省略可能	31.0
`parentFolderId`	String	収容フォルダの ID。	省略可能	31.0
`repositoryFileId`	String	外部ファイルの ID。	省略可能	32.0
`repositoryId`	String	外部データソースの ID。	省略可能	32.0
`title`	String	ファイルのタイトル。	省略可能	24.0

POST の要求パラメータ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`contentModifiedDate`	Date	ファイル固有の最終更新日。クライアント側の更新日を設定するために使用できます。	省略可能	32.0
`desc`	String	ファイルの説明	省略可能	24.0
`isDataSync`	Boolean	要求は自動クライアントによって自動生成されます。	省略可能	31.0
`isInMyFileSync`	Boolean	ファイルが Salesforce Files Sync と同期されている場合は `true`、同期されていない場合は `false`。デフォルト値は、`false` です。	省略可能	31.0
`isMajorVersion`	Boolean	ファイルがメジャーバージョンの場合は `true`、ファイルがマイナーバージョンの場合は `false`。メジャーバージョンを置き換えることはできません。デフォルト値は、`false` です。	省略可能	31.0
`repositoryFileId`	String	外部ファイルの ID。	省略可能	32.0
`repositoryId`	String	外部データソースの ID。	省略可能	32.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/v34.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--

Chatter REST API 開発者ガイド

Users Files, General