共用方式為

使用 Store 服務回應評論

  • 發行項

重要

如本主題所述，Microsoft Store 評論 API 目前未處於運作中狀態。 與其使用 API，您可以使用合作夥伴中心來完成相同的工作。

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

下列步驟描述端到端的處理流程：

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

注意

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

步驟 1：完成使用 Microsoft Store 評論 API 的必要條件

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

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

  • 您必須將 Azure AD 應用程式與您的合作夥伴中心帳戶建立關聯、擷取應用程式的租用戶識別碼和用戶端識別碼，並產生金鑰。 Azure AD 應用程式代表您想要從中呼叫 Microsoft Store 評論 API 的應用程式或服務。 您需要租用戶識別碼、用戶端識別碼和金鑰，才能取得傳遞至 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 Store 評論 API 中的任何方法之前，您必須先為傳遞至 API 中每個方法的授權標題取得 Azure AD 存取權杖。 取得存取權杖之後，您在其到期之前有 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 參數，請在上一節中指定您從合作夥伴中心擷取的應用程式租用戶識別碼、用戶端識別碼和金鑰。 針對 resource 參數，您必須指定 https://manage.devcenter.microsoft.com。

您的存取權杖過期後，您可以按照此處的指示重新整理。

步驟 3：呼叫 Microsoft Store 評論 API

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

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

  1. 取得您想要回應之評論的識別碼。 評論識別碼可在 Microsoft Store 分析 API 中取得應用程式評論方法，以及在 [評論報告](/windows/apps/publish/reviews-report) 的離線下載中取得。
  2. 呼叫取得應用程式評論的回應資訊方法，以判斷您是否允許回應評論。 當客戶提交評論時，他們可以選擇不要收到評論的回應。 您無法回應選擇不接收評論回應的客戶所提交的評論。
  3. 呼叫提交回應至應用程式評論方法，以程序設計方式回應評論。