Внимание! Вскоре будет выпущен обновленный API, для использования которого потребуется перенос данных. Следите за новостями и датами прекращения поддержки. Вы также можете подписаться на нашу рассылку.

Добавление услуг

Организации могут добавлять услуги в данные о компании, указанные в Google Мой бизнес. Это могут быть услуги, предоставляемые в магазине, или предлагаемые покупателям на дому.

Возможность использования и формат

Не все организации могут добавлять услуги в данные о компании, указанные в Google Мой бизнес. Чтобы узнать, доступна ли вам такая возможность, проверьте статус canModifyServiceList в LocationState.

Услуга представлена в качестве ServiceItem и поддерживает два формата, указанные ниже:

  • StructuredServiceItem. Услуги, которые предварительно определены Google, могут быть представлены как StructuredServiceItem с serviceTypeId.
  • FreeFormServiceItem. Чтобы добавить собственные услуги, используйте FreeFormServiceItem с Label.

Список предварительно определенных услуг по названию категории

Чтобы искать предварительно определенные услуги для конкретной категории по ее названию, используйте categories.list. Ниже приведен пример запроса поиска по названию категории salon в Сингапуре.

Запрос

Для CategoryView необходимо указать значение FULL.

HTTP
GET https://mybusiness.googleapis.com/v4/categories?regionCode=SG&languageCode=EN&searchTerm=salon&view=FULL

Ответ

Этот частичный ответ содержит все поддерживаемые типы услуг ServiceTypes.

{
    "categories": [
        {
            "displayName": "Hairdresser",
            "categoryId": "gcid:hair_salon",
            "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.

HTTP
GET https://mybusiness.googleapis.com/v4/categories:batchGet?regionCode=US&languageCode=en&categoryIds=gcid:electrician&view=FULL

Ответ

Ответ содержит все поддерживаемые типы услуг ServiceTypes для gcid:electrician.

{
    "categories": [
        {
            "displayName": "Electrician",
            "categoryId": "gcid: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.getServiceList.

Запрос

HTTP
GET https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList

Ответ

Ниже приведен пример.

{
    "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.updateServiceList и updateMask=serviceItems. Возможность обновления отдельных услуг не поддерживается.

Чтобы настроить услуги в форматах StructuredServiceItem и FreeFormServiceItem, используйте пример ниже:

HTTP
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList?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"
            }
         }
      }
   ]
}