Les établissements peuvent ajouter les services qu'ils proposent à leurs fiches d'établissement. Il peut s'agir de services proposés dans un magasin ou chez les clients.
Éligibilité et format
Tous les établissements ne peuvent pas ajouter de services à leur fiche. Pour savoir si c'est le cas, vérifiez l'état de canModifyServiceList dans Metadata.
Un service est représenté sous la forme d'un ServiceItem, qui accepte les deux formats suivants:
- StructuredServiceItem: les services prédéfinis de Google peuvent être représentés sous forme de
StructuredServiceItem, qui contient unserviceTypeId. - FreeFormServiceItem: pour proposer des services personnalisés, utilisez un
FreeFormServiceItemcontenant un Label.
Lister les services prédéfinis par nom de catégorie
Pour rechercher des services prédéfinis sous une catégorie par nom de catégorie, utilisez categories.list. Vous trouverez une requête pour toutes les catégories qui inclut le nom salon à Singapour dans la section "Requête" suivante.
Requête
La propriété CategoryView doit être définie sur FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Réponse
La réponse partielle suivante renvoie tous les ServiceTypes acceptés.
{
"categories": [
{
"name": "gcid:hair_salon",
"displayName": "Hairdresser",
"serviceTypes": [
{
"serviceTypeId": "job_type_id:body_waxing",
"displayName": "Body Waxing"
},
{
"serviceTypeId": "job_type_id:hair_coloring",
"displayName": "Hair coloring"
},
{
"serviceTypeId": "job_type_id:hair_extensions",
"displayName": "Hair extensions"
},
{
"serviceTypeId": "job_type_id:hair_styling",
"displayName": "Hair styling"
},
{
"serviceTypeId": "job_type_id:manicures",
"displayName": "Manicures"
},
{
"serviceTypeId": "job_type_id:pedicures",
"displayName": "Pedicures"
}
]
}
}
Lister les services prédéfinis par ID de catégorie
Pour rechercher des services prédéfinis en fonction d'un ID de catégorie spécifique, utilisez categories.batchGet. Vous trouverez une requête d'informations pour l'ID de catégorie gcid:electrician aux États-Unis dans la section "Requête" ci-dessous.
Requête
La propriété CategoryView doit être définie sur FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Réponse
La réponse contient tous les ServiceTypes acceptés pour gcid:electrician.
{
"categories": [
{
"name": "gcid:electrician",
"displayName": "Electrician",
"serviceTypes": [
{
"serviceTypeId": "job_type_id:construction",
"displayName": "Construction"
},
{
"serviceTypeId": "job_type_id:electric_car_charger",
"displayName": "Install electric car charger"
},
{
"serviceTypeId": "job_type_id:electrician_remodeling",
"displayName": "Remodeling"
},
{
"serviceTypeId": "job_type_id:general_repairs",
"displayName": "General repairs"
},
{
"serviceTypeId": "job_type_id:install_fan",
"displayName": "Install fan"
},
{
"serviceTypeId": "job_type_id:install_ground_wire",
"displayName": "Install ground wire"
},
{
"serviceTypeId": "job_type_id:install_light_fixtures",
"displayName": "Install light fixtures"
},
{
"serviceTypeId": "job_type_id:install_outdoor_lighting",
"displayName": "Install outdoor lighting"
},
{
"serviceTypeId": "job_type_id:install_outlets_switches",
"displayName": "Install outlets or switches"
},
{
"serviceTypeId": "job_type_id:install_security_system",
"displayName": "Install security system"
},
{
"serviceTypeId": "job_type_id:installation",
"displayName": "Installation"
},
{
"serviceTypeId": "job_type_id:relocate_outlets_switches",
"displayName": "Relocate outlets or switches"
},
{
"serviceTypeId": "job_type_id:repair_fan",
"displayName": "Repair fan"
},
{
"serviceTypeId": "job_type_id:repair_light_fixtures",
"displayName": "Repair light fixtures"
},
{
"serviceTypeId": "job_type_id:repair_outlets_switches",
"displayName": "Repair outlets or switches"
},
{
"serviceTypeId": "job_type_id:repair_panel",
"displayName": "Repair panel"
},
{
"serviceTypeId": "job_type_id:replace_upgrade_panel",
"displayName": "Replace or upgrade panel"
},
{
"serviceTypeId": "job_type_id:restore_power",
"displayName": "Restore power"
}
]
}
]
}
Lister les services existants dans une fiche
Pour obtenir la liste actuelle des services, utilisez locations.get et définissez readMask=serviceItems.
Requête
<ph type="x-smartling-placeholder">
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Réponse
Vous trouverez ci-dessous un exemple de réponse.
{
"serviceItems": [
{
"structuredServiceItem": {
"serviceTypeId": "job_type_id:hair_coloring"
}
},
{
"isOffered": true,
"structuredServiceItem": {
"serviceTypeId": "job_type_id:hair_styling"
}
},
{
"isOffered": true,
"freeFormServiceItem": {
"categoryId": "gcid:barber_shop",
"label": {
"displayName": "Student Cuts"
}
}
}
]
}
Définir les services pour une fiche
Pour mettre à jour des services, utilisez locations.patch et updateMask=serviceItems. Il n'est pas possible de mettre à jour des services individuels.
Pour définir des services avec un élément StructuredServiceItem et un élément FreeFormServiceItem, consultez l'exemple suivant:
<ph type="x-smartling-placeholder">
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=serviceItems
{
"serviceItems":[
{
"isOffered":false,
"structuredServiceItem":{
"serviceTypeId":"job_type_id:hair_coloring"
}
},
{
"isOffered":true,
"structuredServiceItem":{
"serviceTypeId":"job_type_id:hair_styling"
}
},
{
"isOffered":true,
"freeFormServiceItem":{
"categoryId":"gcid:hair_salon",
"label":{
"displayName":"Student Cuts"
}
}
}
]
}