İşletmeler, sağladıkları hizmetleri İşletme Profili girişlerine ekleyebilir. Buna, mağazada veya müşteri konumlarında sunulan hizmetler dahil olabilir.
Uygunluk ve Biçim
Her işletme, İşletme Profili girişine hizmet ekleyemez. Uygunluk durumunu kontrol etmek için Meta veri bölümünde canModifyServiceList
öğesinin durumunu kontrol edin.
Bir hizmet, aşağıdaki iki biçimi destekleyen bir ServiceItem olarak temsil edilir:
- StructuredServiceItem: Google'ın önceden tanımlanmış hizmetleri,
serviceTypeId
içeren birStructuredServiceItem
ile temsil edilebilir. - FreeFormServiceItem: Özel hizmetler sunmak için Etiket içeren bir
FreeFormServiceItem
kullanın.
Önceden tanımlanmış hizmetleri kategori adına göre listeleme
Bir kategori altındaki önceden tanımlanmış hizmetleri kategori adına göre aramak için categories.list kullanın. Singapur'da salon
adını içeren tüm kategorilerle ilgili istek, aşağıdaki İstek bölümünde gösterilir.
İstek
CategoryView, FULL
olarak ayarlanmalıdır.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Yanıt
Aşağıdaki kısmi yanıt, desteklenen tüm ServiceTypes döndürür.
{ "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" } ] } }
Önceden tanımlanmış hizmetleri kategori kimliğine göre listele
Önceden tanımlanmış hizmetleri belirli bir kategori kimliğine göre aramak için categories.batchGet işlevini kullanın. ABD'de gcid:electrician
kategori kimliği altındaki ayrıntı isteği aşağıdaki İstek bölümünde gösterilmektedir.
İstek
CategoryView, FULL
olarak ayarlanmalıdır.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Yanıt
Yanıt, gcid:electrician
için desteklenen tüm ServiceTypes içerir.
{ "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" } ] } ] }
Bir girişteki mevcut hizmetleri listeleme
Hizmetlerin güncel listesini almak için locations.get adresini kullanın ve readMask=serviceItems
ayarını yapın
İstek
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Yanıt
Aşağıda örnek bir yanıt verilmiştir
{ "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" } } } ] }
Bir giriş için hizmetleri ayarlama
Hizmetleri güncellemek için locations.patch ve updateMask=serviceItems
kullanın. Hizmetleri tek tek güncelleme işlemi desteklenmez.
Hizmetleri bir StructuredServiceItem ve bir FreeFormServiceItem ile ayarlamak için aşağıdaki örneğe bakın:
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" } } } ] }