Aktualisieren Sie die Integration der Google Business Profile API, bevor wichtige Endpunkte deaktiviert werden. Im Zeitplan für die Einstellung finden Sie weitere Informationen und eine Anleitung, wie Sie Unterbrechungen ab April 2022 vermeiden können.

Dienstleistungen hinzufügen

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 StructuredServiceItem dargestellt werden, die eine serviceTypeId enthalten.
  • 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.

HTTP
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.

HTTP
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

HTTP
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:

HTTP
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"
            }
         }
      }
   ]
}