Le attività possono aggiungere i servizi forniti alle 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 seguenti due formati:
- StructuredServiceItem: i servizi predefiniti di Google possono essere rappresentati come un
StructuredServiceItem
, che contiene unserviceTypeId
. - FreeFormServiceItem: per offrire servizi personalizzati, utilizza un
FreeFormServiceItem
che contiene un'etichetta.
Elenco dei servizi predefiniti per nome categoria
Per cercare servizi predefiniti in una categoria in base al nome della categoria, utilizza categories.list. Una richiesta per tutte le categorie che includono il nome salon
a Singapore viene mostrata nella seguente sezione della richiesta.
Richiesta
Il valore di 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 un ID categoria specifico, utilizza categories.batchGet. Una richiesta di dettagli per l'ID categoria gcid:electrician
negli Stati Uniti viene mostrata nella sezione Richiesta che segue.
Richiesta
Il valore di 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" } ] } ] }
Elencare i servizi esistenti in una scheda
Per visualizzare un elenco aggiornato dei servizi, utilizza locations.get e impostareadMask=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" } } } ] }
Impostare i servizi per una scheda
Per aggiornare i servizi, utilizza locations.patch e updateMask=serviceItems
. L'aggiornamento dei singoli servizi non è supportato.
Per impostare i servizi con StructuredServiceItem e FreeFormServiceItem, vedi 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" } } } ] }