アプリの申請のコミット
パートナー センターに新しいまたは更新されたアプリの申請をコミットするには、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"
}
応答本文
| 値 | 種類 | Description |
|---|---|---|
| status | string | 申請の状態。 次のいずれかの値を指定できます。
|
エラー コード
要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。
| エラー コード | Description |
|---|---|
| 400 | 要求パラメーターが有効ではありません。 |
| 404 | 指定した申請は見つかりませんでした。 |
| 409 | 指定した申請が見つかりましたが、それの現在の状態ではコミットできなかったか、アプリが現在 Microsoft Store 申請 API でサポートされていないパートナー センター機能を使用しています。 |