パッケージ フライトの作成Create a package flight

パートナーセンターアカウントに登録されているアプリのパッケージフライトを作成するには、Microsoft Store 送信 API でこのメソッドを使用します。Use this method in the Microsoft Store submission API to create a package flight for an app that is registered to your Partner Center account.

注意

このメソッドは、申請なしでパッケージ フライトを作成します。This method creates a package flight without any submissions. パッケージ フライトの申請を作成するには、「パッケージ フライト申請の管理」のメソッドをご覧ください。To create a submission for package flight, see the methods in Manage package flight submissions.

前提条件Prerequisites

このメソッドを使うには、最初に次の作業を行う必要があります。To use this method, you need to first do the following:

  • Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • このメソッドの要求ヘッダーで使う Azure AD アクセス トークンを取得します。Obtain an Azure AD access token to use in the request header for this method. アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。After you obtain an access token, you have 60 minutes to use it before it expires. トークンの有効期限が切れたら新しいトークンを取得できます。After the token expires, you can obtain a new one.

要求Request

このメソッドの構文は次のとおりです。This method has the following syntax. ヘッダーと要求本文の使用例と説明については、次のセクションをご覧ください。See the following sections for usage examples and descriptions of the header and request body.

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

要求ヘッダーRequest header

HeaderHeader TypeType 説明Description
承認Authorization stringstring 必須。Required. Bearer <トークン> という形式の Azure AD アクセス トークン。The Azure AD access token in the form Bearer <token>.

要求パラメーターRequest parameters

名前Name TypeType 説明Description
applicationIdapplicationId stringstring 必須。Required. パッケージ フライトを作成するアプリのストア ID です。The Store ID of the app for which you want to create a package flight. ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。For more information about the Store ID, see View app identity details.

要求本文Request body

要求本文には次のパラメーターがあります。The request body has the following parameters.

パラメーターParameter TypeType 説明Description 必須Required
friendlyNamefriendlyName stringstring 開発者によって指定されているパッケージ フライトの名前。The name of the package flight, as specified by the developer. いいえNo
groupIdsgroupIds arrayarray パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。An array of strings that contain the IDs of the flight groups that are associated with the package flight. フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。For more information about flight groups, see Package flights. いいえNo
rankHigherThanrankHigherThan stringstring 現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。The friendly name of the package flight that is ranked immediately lower than the current package flight. このパラメーターを設定しない場合、新しいパッケージ フライトの順位は、すべてのパッケージ フライトで最も高くなります。If you do not set this parameter, the new package flight will have the highest rank of all package flights. フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。For more information about ranking flight groups, see Package flights. いいえNo

要求の例Request example

次の例は、ストア ID 9WZDNCRD911W を持つアプリの新しいパッケージ フライトを作成する方法を示しています。The following example demonstrates how to create a new package flight for an app that has the Store 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 応答本文を示しています。The following example demonstrates the JSON response body for a successful call to this method. 応答本文の値について詳しくは、次のセクションをご覧ください。For more details about the values in the response body, see the following sections.

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

応答本文Response body

Value TypeType 説明Description
flightIdflightId stringstring パッケージ フライトの ID。The ID for the package flight. この値は、パートナーセンターによって指定されます。This value is supplied by Partner Center.
friendlyNamefriendlyName stringstring 要求で指定されているパッケージ フライトの名前。The name of the package flight, as specified in the request.
groupIdsgroupIds arrayarray 要求で指定されている、パッケージ フライトに関連付けられているフライト グループの ID を含む文字列の配列。An array of strings that contain the IDs of the flight groups that are associated with the package flight, as specified in the request. フライト グループについて詳しくは、「パッケージ フライト」をご覧ください。For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan stringstring 要求で指定されている、現在のパッケージ フライトの次に低位のパッケージ フライトのフレンドリ名。The friendly name of the package flight that is ranked immediately lower than the current package flight, as specified in the request. フライト グループのランク付けについて詳しくは、「パッケージ フライト」をご覧ください。For more information about ranking flight groups, see Package flights.

エラー コードError codes

要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

エラー コードError code 説明Description
400400 要求が無効です。The request is invalid.
409409 現在の状態であるため、パッケージのフライトを作成できませんでした。または、アプリが 現在 Microsoft Store 送信 API でサポートされていないパートナーセンターの機能を使用しています。The package flight could not be created because of its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.