Вы можете добавить в профиль компании услуги, которые оказываете клиентам в магазине или на дому.
Возможность использования и формат
Не все организации могут добавлять услуги в данные о компании, указанные в сервисе "Профиль компании". Чтобы узнать, доступна ли вам такая возможность, проверьте статус canModifyServiceList
в метаданных.
Услуга представлена в качестве ServiceItem и поддерживает два формата, указанные ниже:
- StructuredServiceItem. Услуги, которые предварительно определены Google, могут быть представлены как
StructuredServiceItem
сserviceTypeId
. - FreeFormServiceItem. Чтобы добавить собственные услуги, используйте
FreeFormServiceItem
с Label.
Список предварительно определенных услуг по названию категории
Чтобы искать предварительно определенные услуги для конкретной категории по ее названию, используйте 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" } ] } }
Список предварительно определенных услуг по идентификатору категории
Чтобы искать предварительно определенные услуги для конкретной категории по ее идентификатору, используйте categories.batchGet. Ниже приведен пример запроса по поиску детального описания услуги по идентификатору категории gcid:electrician
для США.
Запрос
Для CategoryView необходимо указать значение FULL
.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Ответ
Ответ содержит все поддерживаемые типы услуг ServiceTypes для 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" } ] } ] }
Список текущих услуг в данных о компании
Чтобы получить список текущих услуг, используйте 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" } } } ] }