reporting info provided via email thread (#3676)

Author: stevewhims

uwp/monetize/get-response-info-for-app-reviews.md

@@ -1,16 +1,19 @@
 ---
-ms.assetid: fb6bb856-7a1b-4312-a602-f500646a3119
-description: Use this method in the Microsoft Store reviews API to determine whether you can respond to a particular review, or whether you can respond to any review for a given app.
 title: Get response info for reviews
-ms.date: 02/08/2017
+description: Use this method in the Microsoft Store reviews API to determine whether you can respond to a particular review, or whether you can respond to any review for a given app.
+ms.assetid: fb6bb856-7a1b-4312-a602-f500646a3119
+ms.date: 07/14/2023
 ms.topic: article
 keywords: windows 10, uwp, Store services, Microsoft Store reviews API, response info
 ms.localizationpriority: medium
 ---
+
 # Get response info for reviews
 
-If you want to programmatically respond to a customer review of your app, you can use this method in the Microsoft Store reviews API to first determine whether you have permission to respond to the review. You cannot respond to reviews submitted by customers who have chosen not to receive review responses. After you confirm that you can respond to the review, you can then use the [submit responses to app reviews](submit-responses-to-app-reviews.md) method to programmatically respond to it.
+> [!IMPORTANT]
+> The *Microsoft Store reviews API*, as documented in this topic, is currently not in a working state. Instead of using the APIs, you can achieve the same task(s) by [using Partner Center](/windows/apps/publish/respond-to-customer-reviews).
 
+If you want to programmatically respond to a customer review of your app, you can use this method in the Microsoft Store reviews API to first determine whether you have permission to respond to the review. You cannot respond to reviews submitted by customers who have chosen not to receive review responses. After you confirm that you can respond to the review, you can then use the [submit responses to app reviews](submit-responses-to-app-reviews.md) method to programmatically respond to it.
 
 ## Prerequisites
 
@@ -22,29 +25,25 @@ To use this method, you need to first do the following:
 
 ## Request
 
-
 ### Request syntax
 
 | Method | Request URI                                                      |
 |--------|------------------------------------------------------------------|
 | GET    | ```https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info``` |
 
-
 ### Request header
 
 | Header        | Type   | Description                                                                 |
 |---------------|--------|-----------------------------------------------------------------------------|
 | Authorization | string | Required. The Azure AD access token in the form **Bearer** <*token*>. |
 
-
 ### Request parameters
 
 | Parameter        | Type   | Description                                     |  Required  |
 |---------------|--------|--------------------------------------------------|--------------|
 | applicationId | string | The Store ID of the app that contains the review for which you want to determine whether you can respond to. The Store ID is available on the [App identity page](/windows/apps/publish/view-app-identity-details) in Partner Center. An example Store ID is 9WZDNCRFJ3Q8. |  Yes  |
 | reviewId | string | The ID of the review you want to respond to (this is a GUID). Review IDs are available in the response data of the [get app reviews](get-app-reviews.md) method in the Microsoft Store analytics API and in the [offline download](/windows/apps/publish/download-analytic-reports) of the [Reviews report](/windows/apps/publish/reviews-report). <br/>If you omit this parameter, the response body for this method will indicate whether you have permissions to respond to any reviews for the specified app. |  No  |
 
-
 ### Request example
 
 The following examples how to use this method to determine whether you can respond to a given review.
@@ -56,14 +55,12 @@ Authorization: Bearer <your access token>
 
 ## Response
 
-
 ### Response body
 
 | Value      | Type   | Description    |  
 |------------|--------|-----------------------|
 | CanRespond      | Boolean  | The value **true** indicates that you can respond to the specified review, or that you have permissions to respond to any review for the specified app. Otherwise, this value is **false**.       |
 | DefaultSupportEmail  | string |  Your app's [support email address](/windows/apps/publish/publish-your-app/enter-app-properties?pivots=store-installer-msix#support-contact-info) as specified in your app's Store listing. If you did not specify a support email address, this field is empty.    |
-
  
 ### Response example
 

uwp/monetize/respond-to-reviews-using-windows-store-services.md

@@ -1,14 +1,18 @@
 ---
-ms.assetid: c92c0ea8-f742-4fc1-a3d7-e90aac11953e
-description: Use the Microsoft Store reviews API to programmatically submit responses to reviews of your app in the Store.
 title: Respond to reviews using Store services
-ms.date: 06/04/2018
+description: Use the Microsoft Store reviews API to programmatically submit responses to reviews of your app in the Store.
+ms.assetid: c92c0ea8-f742-4fc1-a3d7-e90aac11953e
+ms.date: 07/14/2023
 ms.topic: article
 keywords: windows 10, uwp, Microsoft Store reviews API, respond to reviews
 ms.localizationpriority: medium
 ---
+
 # Respond to reviews using Store services
 
+> [!IMPORTANT]
+> The *Microsoft Store reviews API*, as documented in this topic, is currently not in a working state. Instead of using the APIs, you can achieve the same task(s) by [using Partner Center](/windows/apps/publish/respond-to-customer-reviews).
+
 Use the *Microsoft Store reviews API* to programmatically respond to reviews of your app in the Store. This API is especially useful for developers who want to bulk respond to many reviews without using Partner Center. This API uses Azure Active Directory (Azure AD) to authenticate the calls from your app or service.
 
 The following steps describe the end-to-end process:
@@ -77,11 +81,8 @@ The Microsoft Store reviews API contains several methods you can use to determin
 2. Call the [get response info for app reviews](get-response-info-for-app-reviews.md) method to determine whether you are allowed to respond to the reviews. When a customer submits a review, they can choose not to receive responses to their review. You cannot respond to reviews submitted by customers who have chosen not to receive review responses.
 3. Call the [submit responses to app reviews](submit-responses-to-app-reviews.md) method to programmatically respond to the reviews.
 
-
 ## Related topics
 
 * [Get app reviews](get-app-reviews.md)
 * [Get response info for app reviews](get-response-info-for-app-reviews.md)
 * [Submit responses to app reviews](submit-responses-to-app-reviews.md)
-
- 

uwp/monetize/submit-responses-to-app-reviews.md

@@ -1,14 +1,17 @@
 ---
-ms.assetid: 038903d6-efab-4da6-96b5-046c7431e6e7
-description: Use this method in the Microsoft Store reviews API to submit responses to reviews of your app.
 title: Submit responses to reviews
-ms.date: 02/08/2017
+description: Use this method in the Microsoft Store reviews API to submit responses to reviews of your app.
+ms.assetid: 038903d6-efab-4da6-96b5-046c7431e6e7
+ms.date: 07/14/2023
 ms.topic: article
 keywords: windows 10, uwp, Store services, Microsoft Store reviews API, add-on acquisitions
 ms.localizationpriority: medium
 ---
+
 # Submit responses to reviews
 
+> [!IMPORTANT]
+> The *Microsoft Store reviews API*, as documented in this topic, is currently not in a working state. Instead of using the APIs, you can achieve the same task(s) by [using Partner Center](/windows/apps/publish/respond-to-customer-reviews).
 
 Use this method in the Microsoft Store reviews API to programmatically respond to reviews of your app. When you call this method, you must specify the IDs of the reviews you want to respond to. Review IDs are available in the response data of the [get app reviews](get-app-reviews.md) method in the Microsoft Store analytics API and in the [offline download](/windows/apps/publish/download-analytic-reports) of the [Reviews report](/windows/apps/publish/reviews-report).
 
@@ -33,19 +36,16 @@ To use this method, you need to first do the following:
 |--------|------------------------------------------------------------------|
 | POST    | ```https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses``` |
 
-
 ### Request header
 
 | Header        | Type   | Description                                                                 |
 |---------------|--------|-----------------------------------------------------------------------------|
 | Authorization | string | Required. The Azure AD access token in the form **Bearer** <*token*>. |
 
-
 ### Request parameters
 
 This method has no request parameters.
 
-
 ### Request body
 
 The request body has the following values.
@@ -54,7 +54,6 @@ The request body has the following values.
 |---------------|--------|-----------------------------------------|
 | Responses | array | An array of objects that contain the response data you want to submit. For more information about the data in each object, see the following table. |
 
-
 Each object in the *Responses* array contains the following values.
 
 | Value        | Type   | Description           |  Required  |
@@ -65,7 +64,6 @@ Each object in the *Responses* array contains the following values.
 | SupportEmail | string | Your app's support email address, which the customer can use to contact you directly. This must be a valid email address.     |  Yes  |
 | IsPublic | Boolean |  If you specify **true**, your response will be displayed in your app's Store listing, directly below the customer's review, and will be visible to all customers. If you specify **false** and the user hasn't opted out of receiving email responses, your response will be sent to the customer via email, and it will not be visible to other customers in your app's Store listing. If you specify **false** and the user has opted out of receiving email responses, an error will be returned.   |  Yes  |
 
-
 ### Request example
 
 The following example demonstrates how to use this method to submit responses to several reviews.
@@ -102,7 +100,6 @@ Content-Type: application/json
 |---------------|--------|---------------------|
 | Result | array | An array of objects that contain data about each response you submitted. For more information about the data in each object, see the following table.  |
 
-
 Each object in the *Result* array contains the following values.
 
 | Value        | Type   | Description                                                                 |
@@ -112,7 +109,6 @@ Each object in the *Result* array contains the following values.
 | Successful | string | The value **true** indicates that your response was sent successfully. The value **false** indicates that your response was unsuccessful.    |
 | FailureReason | string | If **Successful** is **false**, this value contains a reason for the failure. If **Successful** is **true**, this value is empty.      |
 
-
 ### Response example
 
 The following example demonstrates an example JSON response body for this request.