Skip to main content
POST
翻訳とリップシンクの分数消費、課金、返還の履歴をページ分割して取得します。必要に応じて日付、言語、状態、プロジェクトで絞り込めます。

認証と権限

string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: usage:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

string
テキスト値。許容値: “translation”, “project”. デフォルト値: “translation”.
string
テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/]+$.
string
テキスト値。最小文字数: 1. 最大文字数: 200.
string
テキスト値。最小文字数: 2. 最大文字数: 64.
string
テキスト値。許容値: “all”, “none”, “standard”, “pro”, “pro_2”.
array
値のリスト。要素の構造は完全な入力スキーマを参照してください。最大要素数: 4.
string
テキスト値。許容値: “all”, “charged”, “refunded”, “refund_pending”.
string
テキスト値。形式: “date”. パターン: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
string
テキスト値。形式: “date”. パターン: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
integer
整数値。最小値: 1. 最大値: 100000. デフォルト値: 1.
integer
整数値。最小値: 1. 最大値: 100. デフォルト値: 25.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 ページ分割された翻訳またはプロジェクトの使用量行、正規化済みフィルター、および一致するすべての行の分数合計を返します。

結果フィールド

操作の注意事項

  • view のデフォルトは translation、page は 1、pageSize は 25 です。pageSize の上限は 100 です。
  • 日付フィルターは YYYY-MM-DD を使用し、Europe/Paris の翻訳開始日と比較します。fromDate は toDate より後にはできません。
  • project は大文字と小文字を区別せず、プロジェクト名と ID を検索します。translatedVersionId は translation 表示でバージョン ID に部分一致し、project 表示では無視されます。
  • 合計は、ページ分割前の一致するすべての翻訳行を対象とします。プロジェクト表示では、それらの行をプロジェクト別に集計します。
  • 公開される行には、開始したユーザーのメールアドレスや未加工の処理エラーメッセージは含まれません。

使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

エラー