Share via

パッケージ フライトの作成

  • [アーティクル]

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

注意

このメソッドは、申請なしでパッケージ フライトを作成します。 パッケージ フライトの申請を作成するには、「パッケージ フライト申請の管理」のメソッドをご覧ください。

前提条件

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

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

要求

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

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

要求ヘッダー

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

要求パラメーター

名前 種類 説明
applicationId string 必須。 パッケージ フライトを作成するアプリのストア ID です。 ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。

要求本文

要求本文には次のパラメーターがあります。

パラメーター 種類 説明 必須
friendlyName string 開発者によって指定されているパッケージ フライトの名前。 No
groupIds array パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。 フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。 No
rankHigherThan string 現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。 このパラメーターを設定しない場合、新しいパッケージ フライトの順位は、すべてのパッケージ フライトで最も高くなります。 フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。 いいえ

要求の例

次の例は、ストア ID 9WZDNCRD911W を持つアプリの新しいパッケージ フライトを作成する方法を示しています。

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

Response

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

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

応答本文

値 種類 説明
flightId string パッケージ フライトの ID。 この値はパートナー センターによって提供されます。
friendlyName string 要求で指定されているパッケージ フライトの名前。
groupIds array 要求で指定されている、パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。 フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。
rankHigherThan string 要求で指定されている、現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。 フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。

エラー コード

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

エラー コード 説明
400 要求が無効です。
409 現在の状態が原因でパッケージ フライトを作成できませんでした。または、Microsoft Store 申請 API で現在サポートされていないパートナー センター機能がアプリで使用されています。