取得應用程式資料

  • 發行項

使用 Microsoft Store 提交 API 中的下列方法，取得合作夥伴中心帳戶中現有應用程式的資料。 如需 Microsoft Store 提交 API 的簡介，包括使用 API 的先決條件，請參閱使用 Microsoft Store 服務建立和管理提交。

應用程式必須已存在於您的合作夥伴中心帳戶中，才能使用這些方法。 若要建立或管理應用程式的提交，請參閱管理應用程式提交中的方法。

方法 URI 描述
GET https://manage.devcenter.microsoft.com/v1.0/my/applications 取得所有應用程式的資料
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} 取得特定應用程式的資料
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts 取得應用程式的附加元件
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights 取得應用程式的套件發行小眾測試版

必要條件

如果您尚未這麼做，請先完成 Microsoft Store 提交 API 的所有必要條件後，再嘗試使用這些方法。

資料資源

用於取得應用程式資料的 Microsoft Store 提交 API 方法會使用下列 JSON 資料資源。

應用程式資源

此資源代表已向您的帳戶註冊的應用程式。

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

此資源有下列值。

值 類型 描述
id 字串 應用程式的 Store ID。 如需 Store ID 的詳細資訊，請參閱檢視應用程式識別詳細資料。
primaryName 字串 應用程式的主要名稱。
packageFamilyName 字串 應用程式的套件系列名稱。
packageIdentityName 字串 應用程式的套件身分識別名稱。
publisherName 字串 與應用程式相關聯的 Windows 發行者識別碼。 這會對應至合作夥伴中心內應用程式的應用程式識別頁面上顯示的 Package/Identity/Publisher 值。
firstPublishedDate 字串 應用程式首次發佈的日期，格式為 ISO 8601。
lastPublishedApplicationSubmission object 提交資源，提供應用程式上次發佈的提交之相關資訊。
pendingApplicationSubmission object 提交資源，提供應用程式目前擱置的提交之相關資訊。
hasAdvancedListingPermission 布林值 指出您是否可以針對應用程式的提交設定 gamingOptions 或預告片。 此值適用於在 2017 年 5 月之後建立的提交。

附加元件資源

此資源提供附加元件的相關資訊。

{
    "inAppProductId": "9WZDNCRD7DLK"
}

此資源有下列值。

值 類型 描述
inAppProductId 字串 附加元件的 Store ID。 這個值是由市集所提供。 範例 Store ID 為 9NBLGGH4TNMP。

發行小眾測試版資源

此資源提供應用程式套件發行小眾測試版的相關資訊。

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

此資源有下列值。

值 類型 描述
flightId 字串 套件發行小眾測試版的識別碼。 此值是由合作夥伴中心提供。
friendlyName 字串 套件發行小眾測試版的名稱，如開發人員所指定。
lastPublishedFlightSubmission object 提交資源，提供套件發行小眾測試版上次發佈的提交之相關資訊。
pendingFlightSubmission object 提交資源提供套件發行小眾測試版目前擱置的提交之相關資訊。
groupIds 陣列 字串的陣列，其中包含與套件發行小眾測試版相關聯之發行小眾測試版群組的識別碼。 如需發行小眾測試版群組的詳細資訊，請參閱套件發行小眾測試版。
rankHigherThan 字串 目前套件發行小眾測試版下一個排名之套件發行小眾測試版的易記名稱。 如需發行小眾測試版群組排名的詳細資訊，請參閱套件發行小眾測試版。

提交資源

此資源提供提交的相關資訊。 以下範例示範了此資源的格式。

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

此資源有下列值。

值 類型 描述
id 字串 提交的識別碼。
resourceLocation 字串 您可以附加至基底 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI 的相對路徑，以擷取提交的完整資料。