Services Price Interpretation
Price is a required field. Please take a look at the examples(as displayed to the user) to determine how to represent prices in the feed.
Examples
Price Interpretation:
INTERPRETATION_EXACT As displayed to user: $39.99
{
"service_price": {
"price_interpretation": "INTERPRETATION_EXACT",
"min_price": {
"price_micros": 39990000,
"currency_code": "USD"
}
}
}
As displayed to user: Free
{
"service_price": {
"price_interpretation": "INTERPRETATION_EXACT",
"min_price": {
"price_micros": 0,
"currency_code": "USD"
}
}
}
Price Interpretation:
INTERPRETATION_STARTS_AT As displayed to user : From $0.00
{
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 0,
"currency_code": "USD"
}
}
}
As displayed to user: From $25.00
{
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 25000000,
"currency_code": "USD"
}
}
}
Price Interpretation:
INTERPRETATION_RANGE: As displayed to user: $15.00 - $25.00
{
"service_price": {
"price_interpretation": "INTERPRETATION_RANGE",
"min_price": {
"price_micros": 15000000,
"currency_code": "USD"
},
"max_price": {
"price_micros": 25000000,
"currency_code": "USD"
}
}
}
Price Interpretation: INTERPRETATION_NOT_DISPLAYED
As displayed to user: No price will be displayed to the user
{
"service_price": {
"price_interpretation": "INTERPRETATION_NOT_DISPLAYED"
}
}
Service description is highly recommended, but is optional as we recognize that some services are self-explanatory, and not all merchants provide it. If a service description is identical to the service name, we recommend that the description should be empty to prevent redundancy. However, this will not be enforced.
Examples
When a services description is provided for a services:
{
"localized_service_description": {
"value": "Consultation to learn more about your hair coloring needs and schedule the reservation.",
"Localized_value": {
"locale": "en",
"value": "Consultation to learn more about your hair coloring needs and schedule the reservation."
}
}
}
When no services description is provided for the services:
When a services description is provided but is longer than 120 characters, the description will be truncated:
{
"localized_service_description": {
"value": "Keratin smoothing treatments repair damage, block humidity, and reduce frizz while restoring the hair’s strength & vibrance for healthier hair. Treatment times may vary.",
"Localized_value": {
"locale": "en",
"value": "Keratin smoothing treatments repair damage, block humidity, and reduce frizz while restoring the hair’s strength & vibrance for healthier hair. Treatment times may vary."
}
}
}
Service Category and Ranking Hints Ranking hints affect both the ordering of services within a service category, and the ordering of the categories themselves. The ranking hint for a category is assumed to be the minimum ranking hint of any item in the category. Note that other factors may also influence the final ranking, such as price, user history, etc. The recommended approach is to define a total ordering on all the services, by assigning each one a unique integer ranking hint and ensuring that ranking hint values don’t overlap between categories. For example, if we want the preferred ordering of categories and services to be: Add-ons can be added as its own category, only if they can be booked independently (without a primary service)
Example
{
"data": [
{
"merchant_id":"merchant-1",
"service_id": "services-1",
"localized_service_name": {
"value": "Classic Shave"
},
"localized_service_category": {
"value": "Barber"
},
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 25000000,
"currency_code": "USD"
}
},
"service_duration": {
"duration_interpretation": "INTERPRETATION_EXACT",
"min_duration_sec": 4500
},
"action_link": [
{
"url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
"language": "en"
}
],
"ranking hint": {
"score": 1
}
},
{
"merchant_id":"merchant-1",
"service_id": "services-2",
"localized_service_name": {
"value": "Beard Trim"
},
"localized_service_category": {
"value": "Barber"
},
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 20000000,
"currency_code": "USD"
}
},
"service_duration": {
"duration_interpretation": "INTERPRETATION_EXACT",
"min_duration_sec": 1500
},
"action_link": [
{
"url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
"language": "en"
}
],
"ranking hint": {
"score": 2
}
},
{
"merchant_id":"merchant-1",
"service_id": "services-3",
"localized_service_name": {
"value": "Massage Shampoo"
},
"localized_service_category": {
"value": "Shampoo"
},
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 15000000,
"currency_code": "USD"
}
},
"service_duration": {
"duration_interpretation": "INTERPRETATION_EXACT",
"min_duration_sec": 1500
},
"action_link": [
{
"url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
"language": "en"
}
],
"ranking hint": {
"score": 3
}
},
{
"merchant_id":"merchant-1",
"service_id": "services-4",
"localized_service_name": {
"value": "Buzz Cut"
},
"localized_service_category": {
"value": "Haircuts"
},
"service_price": {
"price_interpretation": "INTERPRETATION_STARTS_AT",
"min_price": {
"price_micros": 35000000,
"currency_code": "USD"
}
},
"service_duration": {
"duration_interpretation": "INTERPRETATION_EXACT",
"min_duration_sec": 3000
},
"action_link": [
{
"url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
"language": "en"
}
],
"ranking hint": {
"score": 4
}
}
]
}
