Microsoft Store 申請 API のこのメソッドを使用して、新規または更新されたアプリの申請をパートナー センターにコミットします。 コミット アクションは、申請データがアップロードされたことをパートナー センターに通知します (関連するパッケージや画像を含む)。 これに対して、パートナー センターは、インジェストと発行のために送信データに対する変更をコミットします。 コミット操作が成功すると、申請に対する変更がパートナー センターに表示されます。
コミット操作が Microsoft Store 申請 API を使用してアプリを提出するプロセスにどのように適合するかの詳細については、「アプリの申請を 管理する」を参照してください。
[前提条件]
このメソッドを使用するには、まず次の操作を行う必要があります。
- まだ行っていない場合は、Microsoft Store 申請 API の
前提条件をすべて満たしてください。 - このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。
- アプリの申請を作成 し、 提出データに 必要な変更を加えて申請を更新します。
リクエスト
このメソッドには、次の構文があります。 ヘッダーと要求本文の使用例と説明については、次のセクションを参照してください。
| メソッド | URI リクエスト |
|---|---|
| 投稿 | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit |
リクエストヘッダー
| ヘッダ | タイプ | 説明 |
|---|---|---|
| 認証 | ひも | 必須。 Bearer<token> 形式の Azure AD アクセス トークン。 |
要求パラメーター
| 名前 | タイプ | 説明 |
|---|---|---|
| アプリケーションID | ひも | 必須。 コミットする申請を含むアプリのストア ID。 ストア ID の詳細については、「 アプリ ID の詳細を表示する」を参照してください。 |
| サブミッションID | ひも | 必須。 コミットしたい申請の 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>
[応答]
次の例は、このメソッドを正常に呼び出す JSON 応答本文を示しています。 応答本文の値の詳細については、次のセクションを参照してください。
{
"status": "CommitStarted"
}
応答内容
| 価値 | タイプ | 説明 |
|---|---|---|
| ステータス | ひも | 申請の状態。 次のいずれかの値を指定できます。
|
エラー コード
要求が正常に完了できない場合、応答には次のいずれかの HTTP エラー コードが含まれます。
| エラー コード | 説明 |
|---|---|
| 400 | 要求パラメーターが無効です。 |
| 404 | 指定された申請が見つかりませんでした。 |
| 409 | 指定した申請が見つかりましたが、現在の状態でコミットできなかったか、Microsoft Store 申請 APIで現在サポートされていない |