Invalid rating
Stay organized with collections
Save and categorize content based on your preferences.
Description
An invalid rating occurs when a review
has the following conditions:
- Equal min rating range and max rating range.
- The review rating does not fall between min and max values (inclusive of the rating range).
How to fix
Deliver the review
with an updated last_update_timestamp
and ensure the following:
- Min rating range and max rating range aren't equal.
- The review rating is within min and max values (inclusive) of the rating range.
Example
On March 1st, you upload the feed file "2017_03_01.xml" to your endpoint. The file contains the
following contents:
<review id="156368" mid="2739">
<reviewer_name>Ada</reviewer_name>
<create_timestamp>2017-02-27T07:55:06Z</create_timestamp>
<last_update_timestamp>2017-02-27T07:55:06Z</last_update_timestamp>
<country_code>US</country_code>
<title >Great prices </title>
<content>My order arrived on time and I got a great price.</content>
<ratings>
<overall min="1" max="10">0</overall>
<customer_service min="1" max="10">10</customer_service>
</ratings>
<collection_method>after_fulfillment</collection_method>
</review>
The above file contains a review with a rating outside the rating range specified. After processing
your feed, the support team notifies you that a data issue, invalid rating, has occurred.
A few days later, after reviewing the documentation, you upload the file "2017_03_04-fix.xml" to
your endpoint to resolve the invalid rating issue. The contents of "2017_03_04-fix.xml" is below:
<review id="156368" mid="2739">
<reviewer_name>Ada</reviewer_name>
<create_timestamp>2017-02-27T07:55:06Z</create_timestamp>
<last_update_timestamp>2017-03-03T08:01:20Z</last_update_timestamp>
<country_code>US</country_code>
<title>Great prices</title>
<content>My order arrived on time and I got a great price.</content>
<ratings>
<overall min="1" max="10">8</overall>
<customer_service min="1" max="10">10</customer_service>
</ratings>
<collection_method>after_fulfillment</collection_method<
</review>
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-08-11 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-08-11 UTC."],[[["\u003cp\u003eAn invalid rating occurs when a review's minimum and maximum rating ranges are equal or when the review rating falls outside the specified minimum and maximum values.\u003c/p\u003e\n"],["\u003cp\u003eTo resolve an invalid rating, ensure the minimum and maximum rating ranges are not equal and that the review rating is within the specified range, inclusive of the minimum and maximum.\u003c/p\u003e\n"],["\u003cp\u003eWhen submitting a corrected review, you must include an updated \u003ccode\u003elast_update_timestamp\u003c/code\u003e to reflect the change.\u003c/p\u003e\n"],["\u003cp\u003eThe example shows a situation where a review had an invalid rating of 0 when the min and max range was between 1 and 10, and how it can be corrected by changing the rating to 8 and updating the \u003ccode\u003elast_update_timestamp\u003c/code\u003e to the correct day.\u003c/p\u003e\n"]]],["An invalid review rating occurs when the minimum and maximum rating ranges are equal, or the review's rating falls outside this range. To fix this, update the `review` with a new `last_update_timestamp`. Ensure the minimum and maximum rating ranges are not equal and the review rating falls within that range. For example, a file containing an invalid rating (0 outside the 1-10 range) was updated, by changing the rating to 8 (within the range), and updating the timestamp.\n"],null,["# Invalid rating\n\nDescription\n-----------\n\nAn invalid rating occurs when a [`review`](/merchant-review-feeds/xmlschema#\u003creview\u003e)\nhas the following conditions:\n\n- Equal min rating range and max rating range.\n- The review rating does not fall between min and max values (inclusive of the rating range).\n\nHow to fix\n----------\n\nDeliver the [`review`](/merchant-review-feeds/xmlschema#\u003creview\u003e)\nwith an updated `last_update_timestamp`\nand ensure the following:\n\n1. Min rating range and max rating range aren't equal.\n2. The review rating is within min and max values (inclusive) of the rating range.\n\nExample\n-------\n\nOn March 1st, you upload the feed file \"2017_03_01.xml\" to your endpoint. The file contains the\nfollowing contents: \n\n```scdoc\n\u003creview id=\"156368\" mid=\"2739\"\u003e\n \u003creviewer_name\u003eAda\u003c/reviewer_name\u003e\n \u003ccreate_timestamp\u003e2017-02-27T07:55:06Z\u003c/create_timestamp\u003e\n \u003clast_update_timestamp\u003e2017-02-27T07:55:06Z\u003c/last_update_timestamp\u003e\n \u003ccountry_code\u003eUS\u003c/country_code\u003e\n \u003ctitle \u003eGreat prices \u003c/title\u003e\n \u003ccontent\u003eMy order arrived on time and I got a great price.\u003c/content\u003e\n \u003cratings\u003e\n \u003coverall min=\"1\" max=\"10\"\u003e0\u003c/overall\u003e\n \u003ccustomer_service min=\"1\" max=\"10\"\u003e10\u003c/customer_service\u003e\n \u003c/ratings\u003e\n \u003ccollection_method\u003eafter_fulfillment\u003c/collection_method\u003e\n\u003c/review\u003e\n```\n\nThe above file contains a review with a rating outside the rating range specified. After processing\nyour feed, the support team notifies you that a data issue, invalid rating, has occurred.\n\nA few days later, after reviewing the documentation, you upload the file \"2017_03_04-fix.xml\" to\nyour endpoint to resolve the invalid rating issue. The contents of \"2017_03_04-fix.xml\" is below: \n\n```scdoc\n\u003creview id=\"156368\" mid=\"2739\"\u003e\n \u003creviewer_name\u003eAda\u003c/reviewer_name\u003e\n \u003ccreate_timestamp\u003e2017-02-27T07:55:06Z\u003c/create_timestamp\u003e\n \u003clast_update_timestamp\u003e2017-03-03T08:01:20Z\u003c/last_update_timestamp\u003e\n \u003ccountry_code\u003eUS\u003c/country_code\u003e\n \u003ctitle\u003eGreat prices\u003c/title\u003e\n \u003ccontent\u003eMy order arrived on time and I got a great price.\u003c/content\u003e\n \u003cratings\u003e\n \u003coverall min=\"1\" max=\"10\"\u003e8\u003c/overall\u003e\n \u003ccustomer_service min=\"1\" max=\"10\"\u003e10\u003c/customer_service\u003e\n \u003c/ratings\u003e\n \u003ccollection_method\u003eafter_fulfillment\u003c/collection_method\u003c\n\u003c/review\u003e\n```"]]