Hizmet Ekleyin

İşletmeler, sağladıkları hizmetleri İşletme Profili girişlerine ekleyebilir. Bu, mağazada sunulan hizmetleri veya müşteri yerlerinde sunulan hizmetleri kapsayabilir.

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

Önceden tanımlanmış hizmetleri kategori adına göre bir kategori altında aramak için categories.list'i kullanın. Singapur'da salon adını içeren tüm kategoriler için yapılan istekler, 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 öğ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 kategori kimliğine göre aramak için categories.batchGet kullanın. Amerika Birleşik Devletleri'nde gcid:electrician kategori kimliği altında bulunan ayrıntılara ilişkin talep, 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: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 bir listesini almak için locations.get işlevini kullanarak readMask=serviceItems öğesini ayarlayı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. Hizmetlerin tek tek güncellenmesi desteklenmez.

Hizmetleri StructuredServiceItem ve FreeFormServiceItem içeren bir şekilde 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"
            }
         }
      }
   ]
}