Files Connect Repository Folder Items
ファイルをアップロードするには、マルチパート/フォームデータ要求で送信します。ファイルのメタデータをマルチパート/フォームデータ要求に JSON または XML リクエストボディとして含めることができます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。
- リソース
-
1/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/items1/connect/communities/communityId/content-hub/repositories/repositoryId/folders/repositoryFolderId/items - 使用可能なバージョン
- 32.0
コミュニティリソースは、バージョン 35.0 以降で使用できます。
- Chatter が必要かどうか
- いいえ
- HTTP メソッド
- GET、HEAD、POST
POST はバージョン 35.0 以降でサポートされます。
- GET の要求パラメータ
-
パラメータ名 型 説明 必須か省略可能 使用可能なバージョン page Integer 項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。 省略可能 32.0 pageSize Integer ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトの 25 に設定されます。 省略可能 32.0 - GET のレスポンスボディ
- Repository Folder Items Collection
- POST のリクエストボディ
- リポジトリへのアップロードは、最大 75 MB です。
リポジトリフォルダに項目を作成する前に、どの種別の項目を作成できるかを確認します。/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/allowed-item-types に対して GET 要求を行います。
-
- ルート XML タグ
- <contentHubInputItem>
- JSON の例
-
1{ 2 "itemTypeId" : "file", 3 "fields" : [ 4 { 5 "name" : "name", 6 "value" : "Content Hub Simple Create Specs" 7 }, 8 { 9 "name" : "description", 10 "value" : "Document explaining the various connect api endpoints required for simple create" 11 }] 12} - プロパティ
-
名前 型 説明 必須か省略可能 使用可能なバージョン fields Files Connect Field Value Input[] 作成する項目のリスト。 ファイル名は必須であるためリポジトリに SharePoint ファイルを作成する場合は必須、それ以外の場合は省略可能 35.0 itemTypeId String 項目種別の ID。 リポジトリにファイルを作成する場合は必須 35.0
- POST のレスポンスボディ
- Repository Folder Item
- POST 要求の例
- 次の例では、ファイルを作成して外部リポジトリにアップロードします。この例は、マルチパート/フォームデータ要求のボディパートを示します。最初のボディパートは Files Connect Item Input リクエストボディです。2 つ目は、ファイルの内容です。詳細は、「バイナリファイルのアップロード」 を参照してください。
1POST /services/data/v48.0/connect/content-hub/repositories/0XCxx000000002CGAQ/ 2folders/folder:0Bz0nXuFg43SiflFNdFNIaUJrY2hQaHVIVHMxYVpHd2ZHeXphTW83TElzcE84RUJ2Q3Q4Rm8/items 3 4Authorization: OAuth 00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA. 5OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyae 6User-Agent: Jakarta Commons-HttpClient/3.0.1 7Host: instance_name 8Content-Length: 489 9Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq 10Accept: application/json 11 12--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq 13Content-Type: application/json 14Content-Disposition: form-data; name="json" 15 16{ 17 "itemTypeId" : "file", 18 "fields" : [ 19 { 20 "name" : "name", 21 "value" : "Items Sharepoint 012.png" 22 }, 23 { 24 "name" : "description", 25 "value" : "This is a test file" 26 }] 27} 28 29--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq 30Content-Disposition: form-data; name="fileData"; filename="items_Sharepoint_012.png" 31Content-Type: image/png 32 33...PNG... 34 35--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq--