共用方式為

使用市集服務回應評論

  • 發行項

重要

Microsoft 市集評價 API，如本主題所述，目前並未正常運作。 您可以使用合作夥伴中心 ，來達成相同的工作，而不是使用 API。

使用 Microsoft 市集評論 API，以程式設計方式回應市集中您 app 的評論。 此 API 特別適用於想要在不使用合作夥伴中心的情況下大量回應許多評論的開發人員。 此 API 會使用 Azure Active Directory （Azure AD） 來驗證來自您的應用程式或服務的呼叫。

下列步驟說明端到端流程：

  1. 確保您已完成所有 的必要條件。
  2. 在 Microsoft Store 評論 API 中呼叫方法之前，取得 Azure AD 存取權杖。 取得令牌之後，您有 60 分鐘的時間在令牌到期之前，在呼叫 Microsoft Store 評論 API 時使用此令牌。 令牌到期之後，您可以產生新的令牌。
  3. 呼叫 Microsoft 市集評論 API。

注意

除了使用 Microsoft 市集評論 API 以程式設計方式回應評論之外，您也可以使用合作夥伴中心 來回應評論。

步驟 1：完成使用 Microsoft 市集檢閱 API 的必要條件

開始撰寫程式代碼以呼叫 Microsoft 市集評論 API 之前，請確定您已完成下列必要條件。

  • 您（或您的組織）必須有 Azure AD 目錄，而且您必須擁有目錄 全域管理員 許可權。 如果您已經從 Microsoft 使用 Microsoft 365 或其他商務服務，則您已有 Azure AD 目錄。 否則，您可以 在合作夥伴中心 建立新的 Azure AD，無需額外費用。

  • 您必須將 Azure AD 應用程式與您的合作夥伴中心帳戶產生關聯、擷取應用程式的租使用者標識碼和用戶端識別碼，並產生密鑰。 Azure AD 應用程式代表您想要從中呼叫Microsoft市集評論 API 的應用程式或服務。 您需要租戶 ID、用戶端 ID 和密鑰，以取得您傳遞至 API 的 Azure AD 存取令牌。

    注意

    您只需要執行此工作一次。 擁有租使用者標識碼、用戶端標識碼和密鑰之後，您隨時都可以重複使用這些標識碼，以建立新的 Azure AD 存取令牌。

若要將 Azure AD 應用程式與您的合作夥伴中心帳戶產生關聯，並擷取所需的值：

  1. 在合作夥伴中心，將組織的合作夥伴中心帳戶與組織的 Azure AD 目錄建立關聯。

  2. 接下來，從合作夥伴中心的 [帳戶 設定] 區段中的 [使用者] 頁面，新增 Azure AD 應用程式，代表您將用來回應評論的應用程式或服務。 請確定您將 管理員 角色指派給此應用程式。 如果應用程式還不存在於 Azure AD 目錄中，您可以在合作夥伴中心 中建立新的 Azure AD 應用程式。

  3. 返回 [使用者] 頁面，按兩下 Azure AD 應用程式的名稱以移至應用程式設定，然後複製 租使用者標識碼，並 用戶端識別碼 值。

  4. 按下 [新增金鑰]。 在接下來的畫面中，記下 金鑰 的值。 離開此頁面之後，您將無法再次存取此資訊。 如需詳細資訊，請參閱 管理 Azure AD 應用程式的金鑰。

步驟 2：取得 Azure AD 存取令牌

在呼叫 Microsoft 市集檢閱 API 中的任何方法之前，您必須先取得 Azure AD 存取令牌，並將其附加於 API 中每個方法的 授權 標頭欄位。 取得存取令牌後，您有 60 分鐘的時間使用它，然後令牌將會過期。 令牌到期之後，您可以重新整理令牌，以便在 API 的進一步呼叫中繼續使用令牌。

若要取得存取令牌，請遵循使用用戶端認證 服務對服務呼叫中的指示，將 HTTP POST 傳送至 https://login.microsoftonline.com/<tenant_id>/oauth2/token 端點。 以下是範例要求。

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

在 POST URI 的 tenant_id 值，以及 client_id 和 client_secret 參數中，請指定您在上一節中從合作夥伴中心擷取的應用程式相關的租用戶識別碼、用戶端識別碼及密鑰。 針對 資源 參數，您必須指定 https://manage.devcenter.microsoft.com。

存取令牌過期之後，您可以依照此處的指示 刷新它。

步驟 3：呼叫Microsoft市集評論 API

擁有 Azure AD 存取令牌之後，您就可以呼叫 Microsoft 市集評論 API。 您必須將存取令牌傳遞至每個方法的 授權 標頭。

Microsoft Store 評論 API 包含多種方法，可用來判斷您是否允許回應特定的評論，並提交對一個或多個評論的回應。 請遵循此流程來使用此 API：

  1. 取得您想要回應之評論的標識碼。 檢閱 ID 可在 Microsoft 市集分析 API 中的 取得應用程式檢閱的響應數據 方法中，以及在 [檢閱報告](/windows/apps/publish/reviews-report)的 脫機下載 中取得。
  2. 呼叫 取得應用程式評論的響應資訊 方法來判斷您是否允許回應評論。 當客戶提交評論時，他們可以選擇不要收到評論的回應。 您無法回應選擇未收到檢閱回應的客戶提交的評論。
  3. 呼叫 提交回應至應用程式評論的方法，以程式自動化方式回應評論。