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
Seuls certains établissements peuvent ajouter des services à leur fiche. Pour savoir si le vôtre en fait partie, vérifiez l'état de canModifyServiceList dans Metadata.
Un service est représenté sous forme de 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 objet
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" ci-dessous.
Requête
L'élement CategoryView doit être défini 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
L'élement CategoryView doit être défini 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
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 d'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 :
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"
}
}
}
]
}