取得應用程式資料Get app data

使用 Microsoft Store 提交 API 中的下列方法,以取得合作夥伴中心帳戶中現有應用程式的資料。Use the following methods in the Microsoft Store submission API to get data for existing apps in your Partner Center account. 如需 Microsoft Store 提交 API 的簡介,包括使用此 API 的必要條件,請參閱使用 Microsoft Store 服務建立和管理提交For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

在您可以使用這些方法之前,應用程式必須已經存在於您的合作夥伴中心帳戶中。Before you can use these methods, the app must already exist in your Partner Center account. 若要為應用程式建立或管理提交,請參閱管理應用程式提交中的方法。To create or manage submissions for apps, see the methods in Manage app submissions.

方法Method URIURI 描述Description
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications 取得您所有應用程式的資料Get data for all your apps
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} 取得特定應用程式的資料Get data for a specific app
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts 取得應用程式的附加元件Get add-ons for an app
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights 取得應用程式套件正式發行前小眾測試版Get package flights for an app

先決條件Prerequisites

如果您尚未完成,請先完成 Microsoft Store 提交 API 的所有必要條件,然後再嘗試使用這其中的任何方法。If you have not done so already, complete all the prerequisites for the Microsoft Store submission API before trying to use any of these methods.

資料資源Data resources

Microsoft Store 提交 API 方法,其使用下列 JSON 資料資源取得應用程式資料。The Microsoft Store submission API methods for getting app data use the following JSON data resources.

應用程式資源Application resource

此資源代表已登錄到您帳戶的應用程式。This resource represents an app that is registered to your account.

{
  "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
}

此資源具有下列值。This resource has the following values.

Value 類型Type 描述Description
idid 字串string 應用程式的 Store 識別碼。The Store ID of the app. 如需有關 Store 識別碼的詳細資訊,請參閱檢視 App 身分識別詳細資料For more information about the Store ID, see View app identity details.
primaryNameprimaryName 字串string 應用程式的主要名稱。The primary name of the app.
packageFamilyNamepackageFamilyName 字串string 應用程式的套件系列名稱The package family name of the app.
packageIdentityNamepackageIdentityName 字串string 應用程式的套件識別資料名稱。The package identity name of the app.
publisherNamepublisherName 字串string 與應用程式相關聯的 Windows 發行者識別碼。The Windows publisher ID that is associated with the app. 這會對應到在合作夥伴中心中,應用程式的應用程式識別頁面上顯示的 [套件/識別/發行者] 值。This corresponds to the Package/Identity/Publisher value that appears on the App identity page for the app in Partner Center.
firstPublishedDatefirstPublishedDate 字串string 第一次發佈應用程式的日期 (格式為 ISO 8601)。The date the app was first published, in ISO 8601 format.
lastPublishedApplicationSubmissionlastPublishedApplicationSubmission 物件 (object)object 提交資源,其提供應用程式最新發行提交的資訊。A submission resource that provides information about the last published submission for the app.
pendingApplicationSubmissionpendingApplicationSubmission 物件 (object)object 提交資源,其提供應用程式目前擱置提交的資訊。A submission resource that provides information about the current pending submission for the app.
hasAdvancedListingPermissionhasAdvancedListingPermission booleanboolean 指出您是否可以為應用程式的提交設定 gamingOptionstrailersIndicates whether you can configure the gamingOptions or trailers for submissions for the app. 這個值對 2017 年 5 月後建立的提交,設為提交。This value is true for submissions created after May 2017.

附加元件資源Add-on resource

此資源提供附加元件的相關資訊。This resource provides information about an add-on.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

此資源具有下列值。This resource has the following values.

Value 類型Type 說明Description
inAppProductIdinAppProductId 字串string 附加元件的 Store 識別碼。The Store ID of the add-on. 此值由 Microsoft Store 所提供。This value is supplied by the Store. Store 識別碼範例為 9NBLGGH4TNMP。An example Store ID is 9NBLGGH4TNMP.

正式發行前小眾測試版資源Flight resource

此資源提供應用程式的套件正式發行前小眾測試版相關資訊。This resource provides information about a package flight for an app.

{
    "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"
}

此資源具有下列值。This resource has the following values.

Value 類型Type 說明Description
flightIdflightId 字串string 套件正式發行前小眾測試版的識別碼。The ID for the package flight. 此值是由合作夥伴中心提供。This value is supplied by Partner Center.
friendlyNamefriendlyName 字串string 開發人員指定的套件正式發行前小眾測試版名稱。The name of the package flight, as specified by the developer.
lastPublishedFlightSubmissionlastPublishedFlightSubmission 物件 (object)object 提交資源,其提供套件正式發行前小眾測試版最新發行提交的資訊。A submission resource that provides information about the last published submission for the package flight.
pendingFlightSubmissionpendingFlightSubmission 物件 (object)object 提交資源,其提供套件正式發行前小眾測試版目前擱置提交的資訊。A submission resource that provides information about the current pending submission for the package flight.
groupIdsgroupIds arrayarray 此字串陣列包含與套件正式發行前小眾測試版相關聯的正式發行前小眾測試版群組的識別碼。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.
rankHigherThanrankHigherThan 字串string 排名位於目前套件正式發行前小眾測試版之下的套件正式發行前小眾測試版易記名稱。The friendly name of the package flight that is ranked immediately lower than the current package flight. 如需有關正式發行前小眾測試版群組排名的詳細資訊,請參閱套件正式發行前小眾測試版For more information about ranking flight groups, see Package flights.

提交資源Submission resource

此資源提供提交的相關資訊。This resource provides information about a submission. 下列範例示範此資源的格式。The following example demonstrates the format of this resource.

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

此資源具有下列值。This resource has the following values.

Value 類型Type 描述Description
idid 字串string 提交的識別碼。The ID of the submission.
resourceLocationresourceLocation 字串string 您可以附加到基底 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI 以抓取提交完整資料的相對路徑。A relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to retrieve the complete data for the submission.