オンラインファイル編集機能の使用方法 - Drive and Photo Service

このトピックでは、Drive および Photo Service のオンラインファイル編集機能について説明します。 Drive および Photo Service では、Drive および Photo Service が提供する BasicUI でファイルをオンラインで編集できます。また、このトピックを参照して、Drive および Photo Service の API 操作を呼び出して、ファイルをオンラインで編集することもできます。

オンラインファイル編集機能は、付加価値機能です。デフォルトでは、この機能は Drive および Photo Service Developer Edition では無効になっています。オンラインファイル編集機能を有効にするには、お問い合わせください。

Drive および Photo Service Developer Edition が提供する付加価値機能は課金対象です。詳細については、「付加価値機能の課金対象項目」をご参照ください。

サポートされているファイル形式

スプレッドシートファイル形式	テキストファイル形式	プレゼンテーションファイル形式
ET、XLS、XLT、XLSX、XLSM、XLTX、XLTM、および CSV	DOC、DOCX、TXT、DOT、WPS、WPT、DOTX、DOCM、DOTM、および RTF	PPT、PPTX、PPTM、PPSX、PPSM、PPS、POTX、POTM、DPT、および DPS

制限

最大 365 人のユーザーがファイルをオンラインで共同編集できます。同時オンラインユーザー数が 50 人を超えると、ページが途切れる場合があります。
オンラインで編集するファイルのサイズは最大 200 MB です。ファイルサイズが 200 MB を超えると、オンラインファイル編集機能は使用できません。
コラボレーションレコードは 180 日間保持されます。

API 呼び出しのプロセスとサンプルコード

1. API 呼び出しのプロセス

注:

操作を呼び出してオンライン編集 URL とトークンを取得し、取得した情報を使用してオンライン編集ページにアクセスできます。
オンライン編集トークンには有効期間があります。トークンの有効期限が切れた場合は、API 操作を呼び出してトークンを更新する必要があります。 office_refresh_token パラメーターを使用して新しいトークンを取得できます。
オンライン編集ページには、フロントエンドテクノロジーに基づいてアクセスします。 Drive および Photo Service が提供する JavaScript 用 SDK を使用してファイルをオンラインで編集することをお勧めします。詳細については、getOfficeEditUrl メソッドと refreshOfficeEditToken メソッドの説明、および「JavaScript 用 SDK」のドキュメントのファイルプレビューの例をご参照ください。

2. オンライン編集 URL を取得する

POST /v2/file/get_office_edit_url

リクエストパラメーター

パラメーター	位置	タイプ	必須	説明
Authorization	header	String		アクセストークン。
x-share-token	header	String		共有トークン。ファイルを共有する場合、このパラメーターを指定できます。このパラメーターを指定する場合、Authorization パラメーターを指定する必要はありません。
drive_id	body	String	いいえ	ドライブ ID 。 drive_id パラメーターと share_id パラメーターは相互排他です。いずれか一方を指定する必要があります。
share_id	body	String	いいえ	共有 ID 。ファイルを共有する場合、このパラメーターを指定できます。このパラメーターを指定する場合、drive_id パラメーターは指定できません。
file_id	body	String	はい	編集するファイルの ID 。
option	body	JSON	いいえ	ファイル編集を制御するために使用されるオプション。

option リクエストパラメーターのパラメーター

パラメーター	位置	タイプ	必須	説明
copy	body	ブール値	いいえ	ユーザーがファイルのコンテンツをコピーすることを許可するかどうかを指定します。
readonly	body	ブール値	いいえ	ファイルが読み取り専用かどうかを指定します。ファイルをオンラインで編集する場合は、このパラメーターを false に設定します。

レスポンスパラメーター

パラメーター	必須	タイプ	説明
edit_url	はい	String	オンライン編集 URL 。
office_access_token	はい	String	アクセストークン。 30 分間有効です。
office_refresh_token	はい	String	更新トークン。 1 日間有効です。

サンプルリクエスト

{
	"drive_id": "testDriveId", // ドライブID
	"file_id": "testFileId", // ファイルID
	"option": {
		"readonly": false, // 読み取り専用かどうか
		"copy": true // コピーを許可するかどうか
	}
}

サンプルレスポンス

{
	"edit_url": "testEditUrl", // 編集URL
	"office_access_token": "testOfficeAccessToken", // アクセストークン
	"office_refresh_token": "testOfficeRefreshToken" // 更新トークン
}

3. オンライン編集トークンを更新する

POST /v2/file/refresh_office_edit_token

リクエストパラメーター

パラメーター	位置	タイプ	必須	説明
Authorization	header	String		アクセストークン。
x-share-token	header	String		共有トークン。ファイルを共有する場合、このパラメーターを指定できます。このパラメーターを指定する場合、Authorization パラメーターを指定する必要はありません。
share_id	body	String	いいえ	共有 ID 。ファイルを共有する場合、このパラメーターを指定できます。
office_access_token	body	String	はい	アクセストークン。
office_refresh_token	body	String	はい	更新トークン。

レスポンスパラメーター

パラメーター	必須	タイプ	説明
office_access_token	はい	String	新しいアクセストークン。 30 分間有効です。
office_refresh_token	はい	String	新しい更新トークン。 1 日間有効です。

サンプルリクエスト

{
	"office_access_token": "testOfficeAccessToken", // アクセストークン
	"office_refresh_token": "testOfficeRefreshToken" // 更新トークン
}

サンプルレスポンス

{
	"office_access_token": "testOfficeAccessToken", // 新しいアクセストークン
	"office_refresh_token": "testOfficeRefreshToken" // 新しい更新トークン
}

4. オンライン編集ページにアクセスする

オンライン編集ページには、フロントエンドテクノロジーに基づいてアクセスします。 Drive および Photo Service が提供する JavaScript 用 SDK を使用してファイルをオンラインで編集することをお勧めします。詳細については、「JavaScript 用 SDK」のドキュメントをご参照ください。

Drive および Photo Service が提供する JavaScript 用 SDK を使用しない場合は、Alibaba Cloud Intelligent Media Management (IMM) のファイルプレビュー機能を使用できます。詳細については、IMM ユーザーガイドのフロントエンド用に提供されている JavaScript 用 SDK の説明をご参照ください。フロントエンド用に提供されている JavaScript 用 SDK を使用する場合は、トークン情報を取得するために使用される操作を、オンライン編集 URL を取得するために使用される Drive および Photo Service の API 操作に置き換え、更新トークンを取得するために使用される操作を、オンライン編集トークンを更新するために使用される Drive および Photo Service の API 操作に置き換えます。

よくある質問

1. ファイルをオンラインで編集するには、どのような権限が必要ですか?

Web クライアントとデスクトップクライアントのオンラインファイル編集機能には、ファイルの更新権限が必要です。

2. ファイルをオンラインで編集する権限を持っているにもかかわらず、ファイルを編集できない場合はどうすればよいですか?

次の手順を実行して、問題のトラブルシューティングを行うことができます。

1. オンラインファイル編集機能は、付加価値機能です。この機能が有効になっているかどうかを確認します。

2. ファイル形式がオンラインファイル編集機能でサポートされているかどうかを確認します。

3. ファイルサイズが 200 MB を超えているかどうかを確認します。

4. Drive および Photo Service のスーパー管理者に連絡して、次の操作を実行してもらいます。管理コンソールにログオンします。左側のナビゲーションウィンドウで、[エンタープライズのカスタマイズ] > [ファイル設定] を選択します。 [ファイル設定] ページで、ファイルアップロード設定を表示します。編集するファイルの形式が、アップロード可能なファイルの形式にリストされていない場合、ファイルをオンラインで編集することはできません。ファイルサイズがアップロードされた単一ファイルに指定された上限を超える場合、オンラインで編集されたファイルを保存することはできません。