ID で収益のエクスポート要求を取得する

既存のキューに登録されたエクスポート要求の状態を取得します。

REST 要求

GET https://api.partner.microsoft.com/v1.0/payouts/transactionhistory/{transactionHistoryRequestId}

要求パラメーター

名前 / 必須 Type 説明
requestId クエリ ○ Guid エクスポート要求 ID

要求ヘッダー

名前 必須 Type 説明
承認 はい String 承認ベアラー トークン。
ms-correlationid いいえ String 内部要求トラッカー。 各要求では、新しいトラッカー (GUID) が生成されます。
ms-requestid いいえ String 要求のべき等 ID。

要求本文

該当なし。

応答ペイロード:

API は HTTP 状態 200 を返します。

要求に基づいて、API は Standard API 応答の状態に記載されている他の標準状態を返すことができます。

名前 説明
400 Bad Request データが見つからないか、正しくありません。
401 権限がありません 呼び出し元は認証されていないため、最初の呼び出しを行う前にパートナー API サービスで認証する必要があります。
403 許可されていません 呼び出し元は、要求を行う権限がありません。
500 内部サーバー エラー API またはその依存関係の 1 つが要求を満たすことができません。 後で再試行してください。
404 見つかりません 入力パラメーターではリソースを使用できません。
429 レート制限 同じ型の要求が多すぎます。 しばらくしてからお試しください。

API 応答ペイロードは、次の属性を返します。

名前 省略可能 説明
値 false 使用可能な値とアクションについては、次の表を参照してください。

使用可能な値とアクション

値 クライアント側の処理
requestId エクスポート要求の要求 ID。
requestDateTime エクスポート要求の開始日時。
requestPath エクスポート要求のクエリ パス。
requestQueryString エクスポート要求の一部として使用されるフィルター。
blobLocation エクスポート ファイルの準備ができたときにトークンを含む BLOB リソース。
Status エクスポート操作の状態。 状態に使用できる値の一覧を次に示します。

状態に使用できる値

  • キューに入っている: エクスポート操作が開始されていません
  • 処理: エクスポート操作が進行中です
  • 失敗: 再試行後にエクスポート操作が失敗し、新しい要求をキューに入れてみてください
  • 完了: エクスポート操作が完了し、エクスポート ファイルをダウンロードする準備ができました。
  • 最終更新: