Le attività possono aggiungere i servizi forniti alle proprie schede del profilo dell'attività. Potrebbero essere inclusi i servizi forniti all'interno di un negozio o quelli offerti presso le sedi dei clienti.
Idoneità e formato
Non tutte le attività possono aggiungere servizi alla propria scheda del profilo dell'attività. Per verificare l'idoneità, controlla lo stato di canModifyServiceList in Metadati.
Un servizio è rappresentato come ServiceItem, che supporta i due formati seguenti:
- StructuredServiceItem: i servizi predefiniti di Google possono essere rappresentati come
StructuredServiceItem, che contiene unserviceTypeId. - FreeFormServiceItem: per offrire servizi personalizzati, utilizza un
FreeFormServiceItemche contiene un'etichetta.
Elencare i servizi predefiniti per nome categoria
Per cercare servizi predefiniti in una categoria per nome categoria, utilizza categories.list. Nella seguente sezione Richiesta viene visualizzata una richiesta per tutte le categorie che includono il nome salon a Singapore.
Richiesta
CategoryView deve essere impostato su FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Risposta
La seguente risposta parziale restituisce tutti i ServiceTypes supportati.
{
"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"
}
]
}
}
Elenca i servizi predefiniti per ID categoria
Per cercare servizi predefiniti in base a uno specifico ID categoria, utilizza categories.batchGet. Nella seguente sezione Richiesta viene visualizzata una richiesta di dettagli sotto l'ID categoria gcid:electrician negli Stati Uniti.
Richiesta
CategoryView deve essere impostato su FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Risposta
La risposta contiene tutti i ServiceTypes supportati per 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"
}
]
}
]
}
Elenca i servizi esistenti in una scheda
Per ottenere un elenco aggiornato dei servizi, utilizza locations.get e setreadMask=serviceItems
Richiesta
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Risposta
Di seguito è riportato un esempio di risposta
{
"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"
}
}
}
]
}
Imposta i servizi per una scheda
Per aggiornare i servizi, utilizza locations.patch e updateMask=serviceItems. L'aggiornamento di singoli servizi non è supportato.
Per impostare i servizi con uno StructuredServiceItem e un FreeFormServiceItem, guarda l'esempio seguente:
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"
}
}
}
]
}