Unternehmen können Dienstleistungen in ihren Google Unternehmensprofil-Einträgen hinzufügen, z. B. solche, die in einem Geschäft oder am Kundenstandort angeboten werden.
Berechtigung und Format
Nicht alle Unternehmen dürfen Dienstleistungen in ihren Google Unternehmensprofil-Einträgen hinzufügen. Die entsprechende Berechtigung lässt sich anhand des Status von canModifyServiceList unter Metadata prüfen.
Ein Dienst wird als ServiceItem dargestellt, das die folgenden zwei Formate unterstützt:
- StructuredServiceItem: Die vordefinierten Dienste von Google können als
StructuredServiceItemdargestellt werden, die eineserviceTypeIdenthalten. - FreeFormServiceItem: Wenn Sie benutzerdefinierte Dienste anbieten möchten, verwenden Sie ein
FreeFormServiceItem, das ein Label enthält.
Vordefinierte Dienste nach Kategoriename auflisten
Verwenden Sie categories.list, um nach vordefinierten Diensten unter einer Kategorie anhand des Kategorienamens zu suchen. Im folgenden Abschnitt „Anfrage“ wird eine Anfrage für alle Kategorien angezeigt, die den Namen salon in Singapur enthalten.
Anfrage
Die CategoryView muss auf FULL gesetzt sein.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Antwort
Die folgende Teilantwort gibt alle unterstützten ServiceTypes zurück.
{
"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"
}
]
}
}
Vordefinierte Dienste nach Kategorie-ID auflisten
Verwenden Sie categories.batchGet, um nach vordefinierten Diensten anhand einer bestimmten Kategorie-ID zu suchen. Eine Anfrage für Details unter der Kategorie-ID gcid:electrician in den USA finden Sie im folgenden Abschnitt „Anfrage“.
Anfrage
Die CategoryView muss auf FULL gesetzt sein.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Antwort
Die Antwort enthält alle unterstützten ServiceTypes für 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"
}
]
}
]
}
Vorhandene Dienste in einem Eintrag auflisten
Mit locations.get und readMask=serviceItems können Sie eine aktuelle Liste der Dienste abrufen.
Anfrage
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Antwort
Hier sehen Sie eine Beispielantwort:
{
"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"
}
}
}
]
}
Dienste für einen Eintrag festlegen
Verwenden Sie zum Aktualisieren von Diensten locations.patch und updateMask=serviceItems. Das Aktualisieren einzelner Dienste wird nicht unterstützt.
Im folgenden Beispiel werden Dienste mit einem StructuredServiceItem und einem FreeFormServiceItem festgelegt:
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"
}
}
}
]
}