> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # 概要 > ストレージ API でファイルのアップロード・ダウンロード・編集・権限制御を実現し、企業ストレージを管理します 本記事では、ストレージとは何か、ストレージ API の機能、およびリソースなどについて説明します。 ## ストレージとは ストレージ API はスマートかつ安全な企業データ管理ソリューションを提供し、ファイルストレージを中心とするオフィスシーンでのコラボレーションニーズに対応します。主な機能には、ファイルのアップロード・ダウンロード・管理・流通、主要なファイルのオンラインプレビューと編集機能、権限管理などが含まれますが、これらに限定されません。ストレージ API を利用することで、シンプルなアプリの添付ファイル機能から複雑なクラウドドライブ製品まで、幅広い機能を実現できます。 ストレージ API をアプリに組み込むことで、次のようなことが実現できます。 * DingTalk のほかのアプリにあるファイルと効率的に連携できます。 * 組織管理者によるファイル管理のニーズに対応できます。詳しくは [DingTalk 管理者バックエンド](https://oa.dingtalk.io/dingtalk-enterprise-storage.htm#/) をご参照ください。 ## オープン概要 ストレージは豊富な API オープン機能を提供しており、開発者は API を通じてストレージと企業の業務システムを連携できます。 ### 企業管理 | **API** | **API 説明** | **API バージョン** | | ------------------------------------------------------------------------------- | -------------------- | ------------- | | [企業情報を取得する](/ja/open/development/obtain-enterprise-storage-related-information) | 企業ストレージに関する情報を取得します。 | 新版 | ### アプリ | **API バージョン** | **API バージョン** | **API バージョン** | | ---------------------------------------------------------------------------------------- | ------------------------- | ------------- | | [グループストレージスペース情報を取得する](/ja/open/development/obtain-group-storage-space-information) | グループストレージスペースの情報を取得します。 | 新版 | | [アプリの身分で指定ユーザーへファイルを送信する](/ja/open/development/sends-a-storage-file-to-a-specified-user) | アプリの身分で指定ユーザーへファイルを送信します。 | 新版 | | [指定チャットへファイルを送信する](/ja/open/development/send-file-to-specified-session) | 指定チャットへファイルを送信します。 | 新版 | | [指定チャットへファイルリンクを送信する](/ja/open/development/send-a-file-link-to-the-specified-session) | 指定チャットへファイルリンクを送信します。 | 新版 | | [アプリ情報を取得する](/ja/open/development/obtains-the-information-about-the-current-application) | アプリ情報を取得します。 | 新版 | ### スペース管理 | **API バージョン** | **API バージョン** | **API バージョン** | | --------------------------------------------------------- | ----------------------- | ------------- | | [スペースを追加する](/ja/open/development/add-space) | 企業ストレージ内に新しいスペースを追加します。 | 新版 | | [スペース情報を取得する](/ja/open/development/get-space-information) | ストレージスペースの情報を取得します。 | 新版 | ### ファイル管理 | **API バージョン** | **API バージョン** | **API バージョン** | | -------------------------------------------------------------------------------------------------- | -------------------------------------- | ------------- | | [フォルダーを追加する](/ja/open/development/add-folder) | ストレージスペース内にフォルダーを追加します。 | 新版 | | [ファイルまたはフォルダーをコピーする](/ja/open/development/copy-an-object) | ファイルまたはフォルダーをコピーします。 | 新版 | | [ファイルまたはフォルダーを一括コピーする](/ja/open/development/copy-files-or-folders-in-bulk) | ファイルまたはフォルダーを一括でコピーします。 | 新版 | | [ファイルまたはフォルダーを移動する](/ja/open/development/move-a-file-or-folder) | ファイルまたはフォルダーの位置情報を移動します。 | 新版 | | [ファイルまたはフォルダーを一括移動する](/ja/open/development/bulk-move-files-or-folders) | ファイルまたはフォルダーを一括で移動します。 | 新版 | | [ファイルまたはフォルダーの名前を変更する](/ja/open/development/rename-a-file-or-folder) | ファイルまたはフォルダーの名前を変更します。 | 新版 | | [ファイルまたはフォルダーを削除する](/ja/open/development/delete-a-file-or-folder) | ファイルまたはフォルダーを削除します。 | 新版 | | [ファイルまたはフォルダーを一括削除する](/ja/open/development/delete-files-or-folders-in-bulk) | ファイルまたはフォルダーを一括で削除します。 | 新版 | | [ファイルの履歴バージョンを復元する](/ja/open/development/restore-previous-versions-of-files) | ファイルの履歴バージョンを復元します。 | 新版 | | [ファイルバージョンリストを取得する](/ja/open/development/obtains-a-list-of-file-versions) | ファイルバージョンのリストを取得します。 | 新版 | | [ファイルまたはフォルダー情報を取得する](/ja/open/development/obtain-file-or-folder-information) | ファイルまたはフォルダーの情報を取得します。 | 新版 | | [ファイルまたはフォルダー情報を一括取得する](/ja/open/development/get-file-or-folder-information-in-bulk) | ファイルまたはフォルダーの情報を一括で取得します。 | 新版 | | [ファイルまたはフォルダーリストを取得する](/ja/open/development/get-a-list-of-files-or-folders) | スペース内のファイルまたはフォルダーリストを取得します。 | 新版 | | [スペース配下のすべてのファイルまたはフォルダーリストを取得する](/ja/open/development/get-a-list-of-all-files-or-folders-under-a) | スペース配下のすべてのファイルまたはフォルダーリストをフラットに取得します。 | 新版 | | [ファイルプレビューまたは編集情報を取得する](/ja/open/development/obtains-the-object-preview-or-editing-information) | ファイルプレビューまたは編集用リンクを取得します。 | 新版 | | [ファイルまたはフォルダーのアプリ属性を更新する](/ja/open/development/update-file-application-properties) | ファイルまたはフォルダーのアプリ属性を更新します。 | 新版 | | [ファイルまたはフォルダーのアプリ属性を削除する](/ja/open/development/delete-file-app-attribute) | ファイルまたはフォルダーのアプリ属性を削除します。 | 新版 | | [ファイルサムネイルを一括取得する](/ja/open/development/get-file-thumbnails-in-bulk) | ファイルのサムネイル情報を一括で取得します。 | 新版 | ### ファイル転送 | **API バージョン** | **API バージョン** | **API バージョン** | | ------------------------------------------------------------------------------------------------------------ | ------------------------------- | ------------- | | [ファイルアップロード情報を取得する](/ja/open/development/obtain-file-upload-informations) | ファイルアップロード情報を取得します。 | 新版 | | [ファイルを送信する](/ja/open/development/submittal-file) | ファイルを送信してアップロードを完了します。 | 新版 | | [ファイルのマルチパートアップロードを初期化する](/ja/open/development/initialize-a-multipart-upload-object) | ファイルのマルチパートアップロードを初期化します。 | 新版 | | [ファイルマルチパートアップロード情報を取得する](/ja/open/development/obtains-the-information-about-multipart-uploads-of-an-object) | ファイル分割後の各パートのアップロード情報を取得します。 | 新版 | | [ファイルダウンロード情報を取得する](/ja/open/development/obtains-the-download-information-about-a-file) | ストレージスペース内のファイルのダウンロード情報を取得します。 | 新版 | ### 権限管理 | **API バージョン** | **API バージョン** | **API バージョン** | | -------------------------------------------------------------------- | -------------------------------------------------------------- | ------------- | | [権限を追加する](/ja/open/development/add-permissions-file) | ストレージスペースの権限を追加します。 | 新版 | | [権限を削除する](/ja/open/development/delete-permissions-file) | ストレージスペースの権限を削除します。 | 新版 | | [権限を変更する](/ja/open/development/modify-permissions-file) | ストレージスペースの権限を変更します。 | 新版 | | [権限リストを取得する](/ja/open/development/get-permission-list) | ストレージスペースの権限リストを取得します。 | 新版 | | [権限継承モードを設定する](/ja/open/development/set-permission-inheritance-mode) | ファイル uuid、操作者 unionId、権限継承モード inheritance に基づき、権限の継承モードを設定します。 | 新版 | | [権限継承モードを取得する](/ja/open/development/get-permission-inheritance-mode) | ファイル uuid と操作者 unionId に基づき、権限継承モードの情報を取得します。 | 新版 | ### ゴミ箱管理 | **API バージョン** | **API バージョン** | **API バージョン** | | --------------------------------------------------------------------------- | --------------------- | ------------- | | [ゴミ箱情報を取得する](/ja/open/development/obtain-information-about-the-recycle-bin) | ゴミ箱の情報を取得します。 | 新版 | | [ゴミ箱アイテムリストを取得する](/ja/open/development/gets-the-list-of-recycle-items) | ゴミ箱内のアイテム情報リストを取得します。 | 新版 | | [ゴミ箱アイテム情報を取得する](/ja/open/development/obtain-recycling-item-information) | ゴミ箱アイテムの情報を取得します。 | 新版 | | [ゴミ箱アイテムを復元する](/ja/open/development/restore-recycle-items) | ゴミ箱アイテムを復元します。 | 新版 | | [ゴミ箱アイテムを一括復元する](/ja/open/development/batch-restore-recycled-items) | ゴミ箱アイテムを一括で復元します。 | 新版 | | [ゴミ箱アイテムを削除する](/ja/open/development/delete-recycle-item) | ゴミ箱内の特定アイテムを削除します。 | 新版 | | [ゴミ箱アイテムを一括削除する](/ja/open/development/batch-delete-recycle-items) | ゴミ箱内のアイテムを一括で削除します。 | 新版 | | [ゴミ箱を空にする](/ja/open/development/empty-the-recycle-bin) | ゴミ箱 Id に基づきゴミ箱を空にします。 | 新版 | ### タスク管理 | **API バージョン** | **API バージョン** | **API バージョン** | | -------------------------------------------------------------------------------------------- | --------------------- | ------------- | | [ストレージの非同期タスク情報を取得する](/ja/open/development/get-the-asynchronous-task-information-in-storage) | ストレージの非同期タスク情報を取得します。 | 新版 | ### イベントサブスクリプション | **API バージョン** | **API バージョン** | **API バージョン** | | ----------------------------------------------------------------------------------- | ------------------------------ | ------------- | | [ファイル変更イベントをサブスクライブする](/ja/open/development/subscribe-to-file-change-events) | ストレージファイル変更イベントをサブスクライブします。 | 新版 | | [ファイル変更イベントのサブスクライブを解除する](/ja/open/development/unsubscribe-from-file-change-events) | ストレージファイル変更イベントのサブスクライブを解除します。 | 新版 | ## チュートリアル DingTalk ではストレージ API の統合フローの例を提供しています。 | **チュートリアル名** | **機能紹介** | **対象範囲** | **Demo ダウンロード** | | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [ドライブファイルのアップロード・プレビュー・ダウンロード](/ja/open/development/dingpan-document) | ドライブファイルのアップロード、ダウンロード、プレビュー | すべての DingTalk 開発者 | [file-demo.zip](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250807/zkuhco/file-demo.zip?spm=ding_open_doc.document.0.0.244b769bqOAIbj\&file=file-demo.zip) | | [ローカルファイルを DingTalk ドキュメント（マイドキュメント）にアップロードする](/ja/open/development/upload-files-dingtalk-documents-documents) | ローカルファイルを DingTalk ドキュメント（マイドキュメント）配下にアップロードします | すべての DingTalk 開発者 | [doc-demo.zip](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250704/bpihcw/doc-demo.zip?spm=ding_open_doc.document.0.0.244b769bqOAIbj\&file=doc-demo.zip) | ## リソース説明 * **スペース**リソースには主に次の属性が含まれます。 | 属性 | タイプ | 説明 | | ---------- | ---------------- | ----------------------------------------------------------------- | | spaceId | string | スペース Id。 | | spaceName | string | スペース名。 | | spaceType | string | スペースタイプ。 - **USER**：ユーザースペース - **APP**：アプリスペース | | quota | int64 | スペース総容量。 **説明** -1 は容量無制限を表します。企業属性がある場合、企業のスペース容量を超えることはできません。 | | usedQuota | int64 | 使用済み容量。 | | createTime | string (iso8601) | 作成時間。 | | modifyTime | string (iso8601) | 編集時間。 | * **ファイルとフォルダー**リソースには主に次の属性が含まれます。 | 属性 | タイプ | タイプ | | ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | | id | string | ファイルまたはフォルダーの id。 | | spaceId | string | スペース Id。 | | path | string | ファイルまたはフォルダーのスペース内のパス。 | | status | string | ステータス。 - **NORMAL**：正常 - **DELETED**：ゴミ箱 - **EXPIRED**：期限切れ | | partitionType | string | ストレージパーティション。 - **PUBLIC\_OSS\_PARTITION**：パブリッククラウド OSS ストレージパーティション - **MINI\_OSS\_PARTITION**：専用 MiniOSS ストレージパーティション | | parentId | string | ファイル目次 Id。 | | fileType | string | ファイルタイプ。 - **FILE**：ファイル - **FOLDER**：フォルダー | | extension | string | ファイル拡張子。 | * **権限**には主に次の属性が含まれます。 | 属性 | タイプ | 説明 | | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | string | 権限ユーザー id。 - type パラメータの値が **ORG** の場合、このパラメータには企業の **corpId** を指定します。 - type パラメータの値が **DEPT** の場合、このパラメータには部門の **deptId** を指定します。[部門リストを取得する](/ja/open/development/user-management-acquires-the-list-departments) インターフェースを呼び出して dept\_id パラメータの値を取得します。 - type パラメータの値が **TAG** の場合、このパラメータには **tag 名** を指定します。 - type パラメータの値が **CONVERSATION** の場合、このパラメータにはチャットの **openConversationId** を指定します。グループチャット作成インターフェースまたはシーングループ作成インターフェースから取得します。 - type パラメータの値が **USER** の場合、このパラメータにはユーザーの **unionId** を指定します。[ユーザー詳細を照会する](/ja/open/development/query-user-details) インターフェースを呼び出して unionid パラメータの値を取得できます。 | | roleId | string | 権限ロール Id。 - **OWNER**：所有者 - **MANAGER**：管理者 - **EDITOR**：編集者 - **DOWNLOADER**：ダウンロード者 - **READER**：閲覧者 | | type | string | 権限ユーザータイプ： - **ORG**：企業 - **DEPT**：部門 - **TAG**：カスタム tag - **CONVERSATION**：チャット - **USER**：ユーザー | | duration | string | 権限付与の有効期間。単位は秒で、デフォルトは -1（永久有効）です。 - 権限を付与するスペースタイプが APP の場合、有効期間は有効になります。 - 権限を付与するスペースタイプが USER の場合、有効期間は無効で、デフォルトで永久有効となります。 |