Hizmet Ekle

İşletmeler, sundukları hizmetleri İşletme Profili girişlerine ekleyebilir. Bu, bir mağazada veya müşteri konumlarında sunulan hizmetler olabilir.

Uygunluk ve Biçim

Tüm işletmeler, İşletme Profili girişlerine hizmet ekleyemez. Uygunluğu kontrol etmek için Meta Veriler bölümünde canModifyServiceList değerinin durumunu kontrol edin.

Hizmetler, aşağıdaki iki biçimi destekleyen bir ServiceItem olarak temsil edilir:

  • StructuredServiceItem: Google'ın önceden tanımlanmış hizmetleri, serviceTypeId içeren bir StructuredServiceItem olarak temsil edilebilir.
  • FreeFormServiceItem: Özel hizmetler sunmak için Etiket içeren bir FreeFormServiceItem kullanın.

Ön tanımlı 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 işlevini kullanın. Singapur'da salon adını içeren tüm kategoriler için bir istek aşağıdaki İstek bölümünde gösterilmektedir.

İstek

CategoryView, FULL olarak ayarlanmalıdır.

HTTP
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 öğelerini 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 listeleme

Ö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ında ayrıntılar isteği aşağıdaki İstek bölümünde gösterilmektedir.

İstek

CategoryView, FULL olarak ayarlanmalıdır.

HTTP
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 değerlerini 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

Mevcut hizmetlerin listesini almak için locations.get işlevini kullanın vereadMask=serviceItems

İstek

HTTP
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"
                }
            }
        }
    ]
}

Giriş için hizmetler ayarlama

Hizmetleri güncellemek için locations.patch ve updateMask=serviceItems öğelerini kullanın. Hizmetleri tek tek güncelleme desteklenmez.

StructuredServiceItem ve FreeFormServiceItem içeren hizmetler ayarlamak için aşağıdaki örneği inceleyin:

HTTP
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"
            }
         }
      }
   ]
}