2023 年 12 月 1 日以降、WebOffice はドキュメントのオープンごとの課金ではなく、API 呼び出しごとの課金に変わりました。この変更は、同日以降に作成されたプロジェクトにのみ適用されます。2023 年 12 月 1 日より前に作成されたプロジェクトは、引き続きオープンごとの課金が適用されます。
課金モデルの比較
API 呼び出しごとの課金では、GenerateWebofficeToken または RefreshWebofficeToken の呼び出しごとに課金が発生します。各トークンは 30 分間有効で、1 人のユーザーのみがドキュメントをオープンできます。複数のユーザーが同じアクセス トークンを使用して同じドキュメントをオープンしようとすると、最後にリクエストしたユーザーのみがオープンできます。以前のユーザーに付与されていたドキュメントのアクセス権限は取り消されます。マルチユーザーアクセスが必要な場合のアクセス失敗を防ぐため、ユーザーがドキュメントをオープンするたびに、ユーザーごとに個別のトークンを生成してください。
|
説明 |
オープンごとの課金 (2023 年 12 月 1 日以前) |
API 呼び出しごとの課金 (2023 年 12 月 1 日以降) |
|
対象プロジェクト |
2023 年 12 月 1 日より前に作成されたプロジェクト |
2023 年 12 月 1 日以降に作成されたプロジェクト |
|
課金が発生するタイミング |
ユーザーがドキュメントをオープンしたとき (接続が確立され、その後切断されます)。 |
GenerateWebofficeToken または RefreshWebofficeToken が呼び出されたとき。 |
|
トークンの有効期限 |
制限はありません。トークンは無期限に有効です。 |
トークンあたり 30 分です。 |
|
マルチユーザーアクセス |
複数のユーザーが 1 つのトークンを共有できます。 |
1 つのトークンで同時に利用できるのは 1 人のユーザーのみです。追加のユーザーには個別のトークンが必要です。 |
|
トークン有効期間内での繰り返しのオープン |
オープンのたびに課金が発生します。 |
API が呼び出されるたびに課金が発生します。クライアント側でトークンをキャッシュし、API を再度呼び出さずに再オープンする場合、追加の課金は発生しません。 |
API 呼び出しごとの課金プランへの切り替え
API 呼び出しごとの課金に切り替えるには、新しいプロジェクトを作成し、それを使用するように連携を更新してください。
IMM コンソールで新しいプロジェクトを作成してください。新しいプロジェクトはデフォルトで API 呼び出しごとの課金を使用します。
-
ユーザーがドキュメントをオープンするたびに GenerateWebofficeToken を呼び出すようにコードを更新し、返されたトークンはそのユーザーにのみ渡してください。ユーザー間でトークンを再利用しないでください。
// ドキュメントのオープン要求ごとに新しいトークンを生成 token = GenerateWebofficeToken(project=<new-project-id>, ...) // トークンは要求したユーザーにのみ渡す API 呼び出しの
projectパラメーターを更新し、新しいプロジェクトを参照するようにしてください。