API総括: ONLYOFFICE DocSpaceおよびDocsの最新アップデート
2025年8月のONLYOFFICE DocSpaceおよびDocs APIのアップデートにより、新たな統合可能性と開発ツールが登場しました。文書ワークフローの構築、カスタムプラグインの作成、既存の技術スタックとの接続など、これらのアップデートは時間を節約し、開発を効率化する実用的なソリューションを提供します。
DocSpace: Backend REST APIの統合サンプル
最新のDocSpace APIアップデートには、実際のユースケースを示す包括的な統合サンプルが含まれています。単なるコードスニペットではなく、プロジェクトに適応できる完全なソリューションです。
Trello統合
双方向ユーザー同期。DocSpaceとTrelloボード間でユーザーを自動的に同期します。これにより手動のオンボーディングが不要となり、プラットフォーム全体でチームの一貫性が保たれます。DocSpaceユーザーをTrelloに追加 / TrelloユーザーをDocSpaceに追加
アセット移行。 Trelloカードの添付ファイルをDocSpaceにインポートできます。このシナリオはプロジェクト引き継ぎを効率化し、ドキュメントを一元化します。
プロジェクト構造の反映。 Trelloボードから直接DocSpaceルームを作成できます。タイトルも一致させることで、統一されたプロジェクト管理が可能になります。以下はコードサンプルです:
import requests
# ONLYOFFICE DocSpace configuration
ONLYOFFICE_API_HOST = "your-docspace.onlyoffice.com"
ONLYOFFICE_API_KEY = "your_onlyoffice_api_key"
# Trello configuration
TRELLO_API_KEY = "your_trello_api_key"
TRELLO_TOKEN = "your_trello_token"
TRELLO_BOARD_ID = "your_board_id"
ONLYOFFICE_HEADERS = {
"Authorization": f"Bearer {ONLYOFFICE_API_KEY}",
"Content-Type": "application/json",
"Accept": "application/json"
}
# Step 1: Get Trello board name
def get_trello_board_name(board_id):
url = f"https://api.trello.com/1/boards/{board_id}"
params = {"key": TRELLO_API_KEY, "token": TRELLO_TOKEN}
response = requests.get(url, params=params)
if response.status_code == 200:
return response.json()["name"]
else:
print(f"Trello board fetch error: {response.status_code}")
return None
# Step 2: Create a DocSpace room with board name
def create_docspace_room(room_title):
url = f"https://{ONLYOFFICE_API_HOST}/api/2.0/files/rooms"
payload = {
"title": room_title,
"roomType": 2, # Collaboration room
"private": True
}
response = requests.post(url, headers=ONLYOFFICE_HEADERS, json=payload)
if response.status_code == 200:
print(f"Room created: {room_title}")
return response.json()
else:
print(f"DocSpace room creation error: {response.status_code}, {response.text}")
return None
# Run integration
if __name__ == "__main__":
board_name = get_trello_board_name(TRELLO_BOARD_ID)
if board_name:
create_docspace_room(board_name)
クラウドストレージ統合
Dropbox接続。新しいDropbox統合はインポートとエクスポートの両方をサポートします。DocSpaceからDropboxにファイルをエクスポートしてアーカイブやバックアップに利用可能です。さらに、Dropboxから直接ファイルをDocSpaceにインポートしてドキュメントを集中管理できます。
フォルダ共有の自動化。DropboxフォルダをDocSpaceのユーザーまたはグループメンバーと自動で共有し、プラットフォーム間のシームレスなコラボレーションを実現します。
NotionとAsanaのワークフロー
Notionユーザー統合。NotionワークスペースのユーザーをDocSpaceと同期し、ドキュメント環境全体で一貫したアクセスを確保します。
Asanaプロジェクト自動化。 Asanaプロジェクトに基づいてDocSpaceルーム構造を生成します。タスクごとにフォルダが自動的に作成され、プロジェクト管理と文書コラボレーションの完全な連携が実現します。
タスクベースの招待。Asanaタスクの担当者を関連するDocSpaceルームに自動招待し、手動でのアクセス管理を不要にします。
DocSpace: プラグインSDKの強化
プラグインSDKには大幅な更新が加えられ、高度なサンプルと基本サンプルが追加され、プラグイン開発を加速します。
高度なプラグインサンプル
- ファイル拡張子フィルタープラグイン – モーダルUIでファイルタイプごとにフィルタリング。
- モーダルダイアログプラグイン – カスタムツールバーから新規文書作成。
- 設定プラグインUI – 管理者向けのカスタム設定画面を提供。
基本コンポーネントサンプル
新しい基本サンプルではUIコンポーネントの実装方法を解説しています:
- API プラグイン – プラットフォームAPI接続の適切な処理方法を示します。
- Box コンポーネント – レイアウトと間隔の設定例。
- Button コンポーネント – インタラクティブ要素の実装。
- ComboBox コンポーネント – ドロップダウン選択インターフェース。
- Text コンポーネント – タイポグラフィとスタイリングオプション。
- ToggleButton コンポーネント – 二状態コントロール。
これらのサンプルはより複雑なプラグイン開発の基盤となるもので、明確な実装パターンを提供します。
Docs APIの新機能: カスタマイズ
新しいsuggestFeatureパラメータにより、新しく追加されたエディタUI要素の表示/非表示を細かく制御できます。
const config = {
editorConfig: {
customization: {
...
suggestFeature: true,
このパラメータは「機能を提案」メニューボタンの表示を制御します。社内利用ではfalse
に設定して提案を非表示にできます。エンドユーザーとの関与を高めたい場合はtrue
にします。
Docs: 新しいOffice APIサンプル
様々なユースケースをサポートするために、実用的なアプリケーションを備えた新しい文書作成サンプルを導入しました。
- 連番。最初の列に連番を追加することで、テーブルのナビゲーションと行の参照を強化します。
- 書式設定されたテーブルの作成。作成時に罫線の追加、ヘッダーのスタイル設定、セル内のテキスト配置などでテーブルを自動的に書式設定します。レポート、データベースのエクスポート、洗練された読みやすいレイアウトを必要とするテンプレートに最適です。
- フィルター付きスプレッドシート。インタラクティブなヘッダーフィルターを備えたスプレッドシートを生成し、ユーザーがデータを簡単に並べ替えてフィルタリングできるようにすることで、シームレスなナビゲーションと分析を可能にします。
- 日付と会社名が入ったフッター。文書に、片側に現在の日付、もう片側に会社名が表示されるフッターを自動的に追加します。メモ、レポート、手紙、テンプレートの標準フォーマットに最適です。
- 自動幅調整テーブル。コンテンツに合わせて列幅を動的に調整するテーブルを含む文書を生成します。
- 箇条書きタスクリスト。タスク、手順、要件などをまとめるのに最適な、明確で整理された箇条書きリストを備えた文書を生成します。
ONLYOFFICEの無料アカウントを登録する
オンラインでドキュメント、スプレッドシート、スライド、フォーム、PDFファイルの閲覧、編集、共同作業