ビジネスが提供しているサービスをビジネス プロフィールのリスティングに追加できます。これには、店頭で提供されるサービスや非店舗型のサービスなどがあります。
対象となるビジネスと形式
すべてのビジネスがビジネス プロフィールのリスティングにサービスを追加できるわけではありません。追加できるかどうかをチェックするには、メタデータで canModifyServiceList の状態を確認してください。
サービスは、次の 2 つの形式をサポートする 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"
}
]
}
}
カテゴリ 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"
}
}
}
]
}