Doanh nghiệp có thể thêm các dịch vụ mà mình cung cấp vào trang thông tin trên Trang doanh nghiệp. Báo cáo này có thể bao gồm những dịch vụ được cung cấp tại cửa hàng hoặc những dịch vụ được cung cấp tại vị trí của khách hàng.
Điều kiện và định dạng
Không phải doanh nghiệp nào cũng có thể thêm dịch vụ vào trang thông tin trên Trang doanh nghiệp của mình. Để kiểm tra xem bạn có đủ điều kiện hay không, hãy kiểm tra trạng thái của canModifyServiceList trong Siêu dữ liệu.
Dịch vụ được biểu thị dưới dạng ServiceItem và hỗ trợ hai định dạng sau:
- StructuredServiceItem: Các dịch vụ được xác định trước của Google có thể được biểu thị dưới dạng
StructuredServiceItem, chứaserviceTypeId. - FreeFormServiceItem: Để cung cấp các dịch vụ tuỳ chỉnh, hãy sử dụng
FreeFormServiceItemcó chứa một Nhãn.
Liệt kê các dịch vụ được xác định trước theo tên danh mục
Để tìm các dịch vụ được xác định trước trong một danh mục theo tên danh mục, hãy sử dụng categories.list. Yêu cầu đối với tất cả danh mục có tên salon ở Singapore sẽ xuất hiện trong phần Yêu cầu bên dưới.
Yêu cầu
CategoryView phải được đặt thành FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Phản hồi
Phản hồi một phần sau đây trả về tất cả ServiceTypes được hỗ trợ.
{
"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"
}
]
}
}
Liệt kê các dịch vụ được xác định trước theo mã danh mục
Để tìm kiếm các dịch vụ được xác định trước theo mã danh mục cụ thể, hãy sử dụng categories.batchGet. Yêu cầu cung cấp thông tin chi tiết thuộc mã danh mục gcid:electrician ở Hoa Kỳ sẽ xuất hiện trong phần Yêu cầu sau đây.
Yêu cầu
CategoryView phải được đặt thành FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Phản hồi
Phản hồi chứa tất cả ServiceTypes được hỗ trợ cho gcid:electrician.
{
"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"
}
]
}
]
}
Liệt kê các dịch vụ hiện có trong một trang thông tin
Để nhận danh sách dịch vụ hiện tại, hãy sử dụng locations.get và đặtreadMask=serviceItems
Yêu cầu
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Phản hồi
Dưới đây là câu trả lời mẫu
{
"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"
}
}
}
]
}
Đặt dịch vụ cho trang thông tin
Để cập nhật các dịch vụ, hãy sử dụng locations.patch và updateMask=serviceItems. Không hỗ trợ cập nhật từng dịch vụ.
Để đặt các dịch vụ có một StructuredServiceItem và FreeFormServiceItem, hãy xem ví dụ sau:
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"
}
}
}
]
}