パッケージ フライトの取得

  • [アーティクル]

パートナー センター アカウントに登録されているアプリのパッケージ フライトに関するデータを取得するには、Microsoft Store 申請 API の以下のメソッドを使います。

前提条件

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

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

要求

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

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

要求ヘッダー

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

要求パラメーター

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

[要求本文]

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

要求の例

次の例は、ストア ID 値が 9WZDNCRD91MD で、アプリの ID が 43e448df-97c9-4a43-a0bc-2a445e736bcd であるパッケージ フライトに関する情報を取得する方法を示しています。

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

Response

次の例は、このメソッドが正常に呼び出された場合の JSON 応答本文を示しています。 応答本文の値について詳しくは、次のセクションをご覧ください。

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

応答本文

値 種類 説明
flightId string パッケージ フライトの ID。 この値はパートナー センターによって提供されます。
friendlyName string 開発者によって指定されているパッケージ フライトの名前。
lastPublishedFlightSubmission object パッケージ フライトの最後に公開された申請に関する情報を提供するオブジェクト。 詳しくは、以下の「申請オブジェクト」セクションをご覧ください。
pendingFlightSubmission object パッケージ フライトの現在保留中の申請に関する情報を提供するオブジェクト。 詳しくは、以下の「申請オブジェクト」セクションをご覧ください。
groupIds array パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。 フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。
rankHigherThan string 現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。 フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。

申請オブジェクト

応答本文の lastPublishedFlightSubmission と pendingFlightSubmission の値には、パッケージ フライトの申請に関するリソース情報を提供するオブジェクトが含まれています。 これらのオブジェクトには、次の値があります。

値 種類 説明
id string 申請 ID。
resourceLocation string 申請の完全なデータを取得するために基本 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI に付加できる相対パス。

エラー コード

要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。

エラー コード Description
400 要求が無効です。
404 指定されたパッケージ フライトは見つかりませんでした。
409 Microsoft Store 申請 API で現在サポートされていないパートナー センター機能がアプリで使用されています。