get_account_financials はセラーが get_adcp_capabilities で account_financials: true を宣言している場合のみ利用可能。オペレーター請求アカウントにのみ適用されます。エージェント請求アカウントの場合、エージェント自身の課金システムが信頼できる情報源となります。
応答時間: 約1秒。
リクエストスキーマ: /schemas/latest/account/get-account-financials-request.json
レスポンススキーマ: /schemas/latest/account/get-account-financials-response.json
クイックスタート
キャンペーン開始前に残りのクレジットを確認します。リクエストパラメーター
レスポンス
成功レスポンス: アカウントの財務データを返します。保証されているのはaccount、currency、period、timezone のみ — その他はセラーが公開する内容による。
エラーレスポンス:
errors— 操作レベルのエラーの配列。財務データは含まれない。
errors のいずれか一方のみ、両方は含まれない。
一般的なシナリオ
キャンペーン開始前の予算確認
プリペイ残高モニタリング
エラーハンドリング
次のステップ
- list_accounts — アカウントを探索してステータスを確認します
- get_adcp_capabilities — このタスクを呼び出す前に
account_financialsを確認します - アカウントとエージェント — 請求モデルとアカウント参照