2023年12月1日、WebOffice の課金は呼び出しごとのポリシーに移行しました。この変更は、API オペレーション GenerateWebofficeToken と RefreshWebofficeToken の課金に特に影響します。呼び出しごとの課金は、この日付以降に作成されたプロジェクトにのみ適用され、ドキュメントのプレビューまたは編集のための API 呼び出し回数に基づいて課金されます。一方、2023年12月1日より前に作成されたプロジェクトは、ドキュメントが開かれた回数に基づいて課金されます。
課金比較
開封ごとの課金: ドキュメントが開かれた回数に基づいて課金されます。ドキュメントの開封操作は、サーバーへの長い接続を開始および確立します。接続が切断されると、課金データが更新されます。この課金ポリシーでは、アクセストークンに時間制限はなく、複数のユーザーがドキュメントを何度でも開くために使用できます。ただし、ドキュメントが開かれるたびに料金が発生します。
呼び出しごとの課金: API オペレーション (GenerateWebofficeToken および RefreshWebofficeToken) の呼び出し回数に基づいて課金されます。呼び出しごとに料金が発生します。呼び出しはアクセストークンを返します。これにより、1 人のユーザーがドキュメントを 30 分間開くことができます。トークンの有効期間内にドキュメントを複数回開いても、1 回分の料金しか発生しません。複数のユーザーが同じアクセストークンを使用して同じドキュメントを開こうとした場合、最後にリクエストを行ったユーザーのみが開くことができます。以前のユーザーに付与されたドキュメントアクセス許可は取り消されます。ドキュメントアクセスエラーを回避するには、ドキュメントを開くたびに新しいアクセストークンを使用してください。
次の表は、2 つの課金ポリシーの違いを示しています。
開封ごとの課金 (2023年12月1日より前に作成されたプロジェクトの場合) | 呼び出しごとの課金 (2023年12月1日以降に作成されたプロジェクトの場合) | |
料金が発生するタイミング | ドキュメント開封からの長い接続が切断されたとき。 | API オペレーション呼び出しが行われたとき。 |
許可されるユーザー数の制限 | そのような制限は適用されません。アクセストークンは複数のユーザーが使用できます。 | アクセストークンは、一度に 1 人のユーザーがドキュメントにアクセスするためにのみ使用できます。複数のユーザーが同時にドキュメントにアクセスするには、各ユーザーに異なるアクセストークンが必要です。 |
課金ポリシーの切り替え
IMM コンソールでプロジェクトを作成します。プロジェクトはデフォルトで呼び出しごとの課金を使用します。
ドキュメント開封操作が要求されるたびにアクセストークンを生成するようにコードを調整し、アクセストークンを一度に 1 人のユーザーのみが使用できるようにします。
API 呼び出しで元のプロジェクトを新しく作成したプロジェクトに置き換えます。