Share via

パッケージ フライトの申請のコミット

  • [アーティクル]

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

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

前提条件

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

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

要求

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

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

要求ヘッダー

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

要求パラメーター

名前 種類 説明
applicationId string 必須。 コミットするパッケージ フライトの申請が含まれるアプリのストア ID です。 アプリの Store ID は、パートナー センターで確認できます。
flightId string 必須。 コミットする申請が含まれるパッケージ フライトの ID です。 この ID は、パッケージ フライトの作成要求とアプリのパッケージ フライトの取得要求の応答データで確認できます。 フライトをパートナー センターで作成した場合、この ID は、パートナー センターのフライト ページの URL でも確認できます。
submissionId string 必須。 コミットする申請の ID です。 この ID は、パッケージ フライトの申請の作成要求に対する応答データで確認できます。 アプリの申請をパートナー センターで作成した場合、この ID は、パートナー センターの申請ページの URL でも確認できます。

[要求本文]

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

要求の例

次の例は、パッケージ フライトの申請をコミットする方法を示しています。

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/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 でサポートされていないパートナー センター機能を使用しています。