Hizmet Ekleyin

İş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 bir StructuredServiceItem 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.

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 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.

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 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

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

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:

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