비즈니스에서 제공하는 서비스를 비즈니스 프로필 비즈니스 정보에 추가할 수 있습니다. 여기에는 매장에서 제공되는 서비스 또는 고객 위치에서 제공되는 서비스가 포함될 수 있습니다.
자격 요건 및 형식
일부 비즈니스는 비즈니스 프로필 비즈니스 정보에 서비스를 추가할 수 없습니다. Metadata에서 canModifyServiceList의 상태를 보면 자격 요건을 확인할 수 있습니다.
서비스는 다음 두 형식을 지원하는 ServiceItem으로 표현됩니다.
- StructuredServiceItem: Google의 사전 정의된 서비스는
serviceTypeId를 포함하는StructuredServiceItem으로 표시할 수 있습니다. - FreeFormServiceItem: 맞춤 서비스를 제공하려면 라벨이 포함된
FreeFormServiceItem을 사용합니다.
카테고리 이름별로 사전 정의된 서비스 나열
카테고리 이름으로 카테고리별로 사전 정의된 서비스를 검색하려면 categories.list를 사용합니다. 다음 요청 섹션에 싱가포르에서 이름이 salon인 항목을 포함하는 모든 카테고리에 대한 요청이 표시되어 있습니다.
요청
CategoryView를 FULL로 설정해야 합니다.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
응답
아래의 부분 응답은 지원되는 모든 ServiceTypes를 반환합니다.
{
"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"
}
]
}
}
카테고리 ID별로 사전 정의된 서비스 나열
특정 카테고리 ID별로 사전 정의된 서비스를 검색하려면 categories.batchGet을 사용합니다. 아래의 요청 섹션에는 미국의 카테고리 ID gcid:electrician에 대한 세부정보 요청이 표시되어 있습니다.
요청
CategoryView를 FULL로 설정해야 합니다.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
응답
응답에는 gcid:electrician에 대해 지원되는 모든 ServiceTypes가 포함됩니다.
{
"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"
}
]
}
]
}
비즈니스 정보의 기존 서비스 나열
현재의 서비스 목록을 가져오려면 locations.get를 사용하고 readMask=serviceItems를 설정하세요.
요청
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
응답
아래는 샘플 응답입니다.
{
"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"
}
}
}
]
}
비즈니스 정보의 서비스 설정
서비스를 업데이트하려면 locations.patch 및 updateMask=serviceItems를 사용하세요. 개별 서비스 업데이트는 지원되지 않습니다.
StructuredServiceItem 및 FreeFormServiceItem으로 서비스를 설정하려면 다음 예를 참고하세요.
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"
}
}
}
]
}