アドオンの申請のコミット

  • [アーティクル]

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

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

前提条件

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

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

要求

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

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

要求ヘッダー

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

要求パラメーター

名前 種類 説明
inAppProductId string 必須。 コミットする申請が含まれるアドオンのストア ID です。 Store ID はパートナー センターで確認することができ、すべてのアドオンの入手とアドオンの作成への要求の応答データに含まれています。
submissionId string 必須。 コミットする申請の ID です。 この ID は、アドオンの申請の作成要求に対する応答データで確認できます。 アプリの申請をパートナー センターで作成した場合、この ID は、パートナー センターの申請ページの URL でも確認できます。

[要求本文]

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

要求の例

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

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/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 でサポートされていないパートナー センター機能が使用されています。