取得應用程式

  • 發行項

在 Microsoft Store 提交 API 中使用此方法，擷取向合作夥伴中心帳戶註冊之特定應用程式的相關資訊。

必要條件

要使用此方法，您需要先執行以下操作：

  • 如果您尚未執行此操作，請完成 Microsoft Store 提交 API 的所有必要條件。
  • 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。

要求

此方法具有下列語法。 如需標頭和要求本文的使用範例和描述，請參閱下列各節。

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

要求標頭

標題 類型 描述
授權 字串 必要。 持有人<權杖>形式的 Azure AD 存取權杖。

要求參數

名稱 類型​​ 描述
applicationId 字串 必要。 要擷取之應用程式的 Store ID。 如需 Store ID 的詳細資訊，請參閱檢視應用程式識別詳細資料。

要求本文

請勿提供此方法的要求本文。

要求範例

下列範例示範如何使用 Store ID 值 9NBLGGH4R315 擷取應用程式的相關資訊。

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315 HTTP/1.1
Authorization: Bearer <your access token>

回應

下面的範例示範成功呼叫此方法的 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": false
}

錯誤碼

如果要求無法成功完成，回應將會包含下列其中一個 HTTP 錯誤碼。

錯誤碼 描述
404 找不到指定的向合作夥伴中心帳戶註冊。
409 應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。