アプリの申請のコミット

  • [アーティクル]

パートナー センターに新しいまたは更新されたアプリの申請をコミットするには、Microsoft Store 申請 API のこのメソッドを使用します。 コミット アクションにより、申請データ (関連パッケージおよび画像を含む) がアップロードされたことがパートナー センターに通知されます。 その応答として、パートナー センターは、申請データへの変更をインジェストと公開のためにコミットします。 コミット操作が成功すると、申請への変更がパートナー センターに示されます。

コミット操作が Microsoft Store 申請 API を使ったアプリ申請プロセスにどのように適合するかについては、「アプリの申請の管理」をご覧ください。

前提条件

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

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

要求

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

認証方法 要求 URI
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit

要求ヘッダー

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

要求パラメーター

名前 種類 説明
applicationId string 必須。 コミットする申請が含まれるアプリのストア ID です。 ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。
submissionId string 必須。 コミットする申請の ID です。 この ID は、アプリの申請の作成要求に対する応答データで確認できます。 アプリの申請をパートナー センターで作成した場合、この ID は、パートナー センターの申請ページの URL でも確認できます。

[要求本文]

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

要求の例

次の例は、アプリの申請をコミットする方法を示しています。

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/commit HTTP/1.1
Authorization: Bearer <your access token>

Response

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

{
  "status": "CommitStarted"
}

応答本文

値 種類 説明
status string 申請の状態。 次のいずれかの値を指定できます。
  • なし
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • 発行
  • 公開済み
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • 認定資格
  • CertificationFailed
  • リリース
  • ReleaseFailed

エラー コード

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

エラー コード 説明
400 要求パラメーターが有効ではありません。
404 指定した申請は見つかりませんでした。
409 指定した申請が見つかりましたが、それの現在の状態ではコミットできなかったか、アプリが現在 Microsoft Store 申請 API でサポートされていないパートナー センター機能を使用しています。