アプリの申請のコミットCommit an app submission

Microsoft Store 送信 API でこのメソッドを使用して、パートナー センターに新しいまたは更新されたアプリの提出をコミットします。Use this method in the Microsoft Store submission API to commit a new or updated app submission to Partner Center. コミット アクション アラート パートナー センター (すべての関連するパッケージとイメージを含む) の送信データがアップロードされています。The commit action alerts Partner Center that the submission data has been uploaded (including any related packages and images). 応答では、パートナー センターは、送信データの取り込みおよび発行に変更をコミットします。In response, Partner Center commits the changes to the submission data for ingestion and publishing. コミット操作が成功すると、パートナー センターで、送信への変更が表示されます。After the commit operation succeeds, the changes to the submission are shown in Partner Center.

コミット操作が Microsoft Store 申請 API を使ったアプリ申請プロセスにどのように適合するかについては、「アプリの申請の管理」をご覧ください。For more information about how the commit operation fits into the process of submitting an app by using the Microsoft Store submission API, see Manage app submissions.

前提条件Prerequisites

このメソッドを使うには、最初に次の作業を行う必要があります。To use this method, you need to first do the following:

  • Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。Obtain an Azure AD access token to use in the request header for this method. アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。After you obtain an access token, you have 60 minutes to use it before it expires. トークンの有効期限が切れたら新しいトークンを取得できます。After the token expires, you can obtain a new one.
  • アプリの申請を作成し、申請データを必要に応じて変更して申請を更新します。Create an app submission and then update the submission with any necessary changes to the submission data.

要求Request

このメソッドの構文は次のとおりです。This method has the following syntax. ヘッダーと要求本文の使用例と説明については、次のセクションをご覧ください。See the following sections for usage examples and descriptions of the header and request body.

メソッドMethod 要求 URIRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit

要求ヘッダーRequest header

HeaderHeader 種類Type 説明Description
AuthorizationAuthorization stringstring 必須。Required. Bearer <トークン> という形式の Azure AD アクセス トークン。The Azure AD access token in the form Bearer <token>.

要求パラメーターRequest parameters

名前Name 種類Type 説明Description
applicationIdapplicationId stringstring 必須。Required. コミットする申請が含まれるアプリのストア ID です。The Store ID of the app that contains the submission you want to commit. ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring 必須。Required. コミットする申請の ID です。The ID of the submission you want to commit. この ID は、アプリの申請の作成要求に対する応答データで確認できます。This ID is available in the response data for requests to create an app submission. パートナー センターで作成された送信、この ID はパートナー センターでの送信 ページの URL で使用できるも。For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

要求本文Request body

このメソッドでは要求本文を指定しないでください。Do not provide a request body for this method.

要求の例Request example

次の例は、アプリの申請をコミットする方法を示しています。The following example demonstrates how to commit an app submission.

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

応答Response

次の例は、このメソッドが正常に呼び出された場合の JSON 応答本文を示しています。The following example demonstrates the JSON response body for a successful call to this method. 応答本文の値について詳しくは、次のセクションをご覧ください。For more details about the values in the response body, see the following sections.

{
  "status": "CommitStarted"
}

応答本文Response body

ValueValue 種類Type 説明Description
statusstatus stringstring 申請の状態。The status of the submission. 次のいずれかの値を使用できます。This can be one of the following values:
  • なしNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • 公開Publishing
  • 公開済みPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • 認定Certification
  • CertificationFailedCertificationFailed
  • リリースRelease
  • ReleaseFailedReleaseFailed

エラー コードError codes

要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

エラー コードError code 説明Description
400400 要求パラメーターが有効ではありません。The request parameters are invalid.
404404 指定した申請は見つかりませんでした。The specified submission could not be found.
409409 指定した送信が見つかりましたが、現在の状態で、コミットできなかったまたは、アプリはパートナー センター機能を使用する現在サポートされていません、Microsoft Store 送信 APIします。The specified submission was found but it could not be committed in its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.