パッケージフライトの申請の更新

[アーティクル]
10/17/2024

既存のパッケージフライトの申請を更新するには、Microsoft Store 申請 API の以下のメソッドを使います。このメソッドを使って申請を正常に更新した後は、インジェストと公開のために申請をコミットする必要があります。

このメソッドが Microsoft Store 申請 API を使ったパッケージフライト申請の作成プロセスにどのように適合するかについては、「パッケージフライトの申請の管理」をご覧ください。

前提条件

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

Microsoft Store 申請 API に関するすべての前提条件を満たします (前提条件がまだ満たされていない場合)。
このメソッドの要求ヘッダーで使う Azure AD アクセストークンを取得します。アクセストークンを取得した後、アクセストークンを使用できるのは、その有効期限が切れるまでの 60 分間です。トークンの有効期限が切れたら新しいトークンを取得できます。
いずれかのアプリのパッケージフライトの申請を作成します。この操作は、パートナーセンターで実行するか、パッケージフライトの申請の作成メソッドを使って実行することができます。

要求

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

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

要求ヘッダー

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

要求パラメーター

名前	種類	内容
applicationId	string	必須。パッケージフライト申請を更新するアプリのストア ID です。ストア ID について詳しくは、「アプリ ID の詳細の表示」をご覧ください。
flightId	string	必須。申請を更新するパッケージフライトの ID です。この ID は、パッケージフライトの作成要求とアプリのパッケージフライトの取得要求の応答データで確認できます。フライトをパートナーセンターで作成した場合、この ID は、パートナーセンターのフライトページの URL でも確認できます。
submissionId	string	必須。更新する申請の ID です。この ID は、パッケージフライトの申請の作成要求に対する応答データで確認できます。アプリの申請をパートナーセンターで作成した場合、この ID は、パートナーセンターの申請ページの URL でも確認できます。
packageId	string	必須。既存のパッケージの ID。

要求本文

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

値	種類	説明
flightPackages	array	申請の各パッケージに関する詳細を提供するオブジェクトが含まれています。応答本文の値について詳しくは、「フライトパッケージリソース」をご覧ください。このメソッドを呼び出してアプリの申請を更新するとき、要求の本文では、これらのオブジェクトの値 fileName、fileStatus、minimumDirectXVersion、minimumSystemRam だけが必須です。他の値はパートナーセンターによって設定されます。
packageDeliveryOptions	object	申請の段階的なパッケージのロールアウトと必須の更新の設定が含まれています。詳しくは、「パッケージの配信オプションオブジェクト」をご覧ください。
targetPublishMode	string	申請の公開モードです。次のいずれかの値を指定できます。即時手動 SpecificDate
targetPublishDate	string	targetPublishMode が SpecificDate に設定されている場合、ISO 8601 形式での申請の公開日です。
notesForCertification	string	テストアカウントの資格情報や、機能のアクセスおよび検証手順など、審査担当者に対して追加情報を提供します。詳しくは、「認定の注意書き」をご覧ください。

要求の例

アプリのパッケージフライト申請を更新する方法の例を次に示します。

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Response

次の例は、このメソッドが正常に呼び出された場合の JSON 応答本文を示しています。応答本文には、更新された申請に関する情報が含まれています。応答本文の値について詳しくは、「パッケージフライトの申請のリソース」を参照してください。

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

エラーコード

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

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

次の方法で共有

パッケージフライトの申請の更新

前提条件

要求

要求ヘッダー

要求パラメーター

要求本文

要求の例

Response

エラーコード

フィードバック

その他のリソース

次の方法で共有

パッケージ フライトの申請の更新

前提条件

要求

要求ヘッダー

要求パラメーター

要求本文

要求の例

Response

エラー コード

関連トピック

フィードバック

その他のリソース

パッケージフライトの申請の更新

エラーコード