アドオンの申請の状態の取得

  • [アーティクル]

アドオン (アプリ内製品または IAP とも呼ばれます) の申請の状態を取得するには、Microsoft Store 申請 API の以下のメソッドを使います。 Microsoft Store 申請 API を使ったアドオンの申請の作成プロセスについて詳しくは、「アドオンの申請の管理」をご覧ください。

前提条件

このメソッドを使うには、最初に次の作業を行う必要があります。

  • Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
  • このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら新しいトークンを取得できます。
  • いずれかのアプリのアドオンの申請を作成します。 これは、パートナー センターで、またはアドオンの申請の作成メソッドを使用して実行できます。

要求

このメソッドの構文は次のとおりです。 ヘッダーと要求本文の使用例と説明については、次のセクションをご覧ください。

認証方法 要求 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/status

要求ヘッダー

Header 型 説明
承認 string 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。

要求パラメーター

名前 種類 説明
inAppProductId string 必須。 状態を取得する申請が含まれているアドオンのストア ID です。 Store ID は、パートナー センターで確認できます。
submissionId string 必須。 状態を取得する申請の ID です。 この ID は、アドオンの申請の作成要求に対する応答データで確認できます。 アプリの申請をパートナー センターで作成した場合、この ID は、パートナー センターの申請ページの URL でも確認できます。

[要求本文]

このメソッドでは要求本文を指定しないでください。

要求の例

次の例は、アドオン申請の状態を取得する方法を示しています。

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status HTTP/1.1
Authorization: Bearer <your access token>

Response

次の例は、このメソッドが正常に呼び出された場合の JSON 応答本文を示しています。 応答本文には、指定された申請に関する情報が含まれています。 応答本文の値について詳しくは、次のセクションをご覧ください。

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

応答本文

値 種類 Description
status string 申請の状態。 次のいずれかの値を指定できます。
  • なし
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • 発行
  • 公開済み
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • 認定資格
  • CertificationFailed
  • リリース
  • ReleaseFailed
statusDetails object エラーに関する情報など、申請の状態に関する追加詳細情報が含まれています。 詳しくは、ステータスの詳細に関するリソースをご覧ください。

エラー コード

要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。

エラー コード 説明
404 申請は見つかりませんでした。
409 Microsoft Store 申請 API で現在サポートされていないパートナー センター機能がアドオンで使用されています。