Hinweis: Es stehen größere Änderungen an der API an, für die Migrationen erforderlich sein werden. Aktuelle Informationen finden Sie auf der Seite Anstehende Releases der Google My Business API und im Zeitplan für die Einstellung. Sie können sich auch auf die Mailingliste setzen lassen, um entsprechende Benachrichtigungen zu erhalten.

Dienste hinzufügen

Unternehmen können in ihre GMB-Einträge Dienste einfügen. Dazu gehören z. B. Dienste, die in einem Geschäft oder am Kundenstandort angeboten werden.

Berechtigung und Format

Nicht alle Unternehmen können in ihren GMB-Eintrag Dienste einfügen. Die Berechtigung lässt sich anhand des Status von canModifyServiceList unter LocationState 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://mybusiness.googleapis.com/v4/categories?regionCode=SG&languageCode=EN&searchTerm=salon&view=FULL

Antwort

Die folgende Teilantwort gibt alle unterstützten ServiceTypes zurück.

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

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://mybusiness.googleapis.com/v4/categories:batchGet?regionCode=US&languageCode=en&categoryIds=gcid:electrician&view=FULL

Antwort

Die Antwort enthält alle unterstützten ServiceTypes für 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"
                }
            ]
        }
    ]
}

Vorhandene Dienste in einem Eintrag auflisten

Mit locations.getServiceList können Sie eine aktuelle Liste der Dienste abrufen.

Anfrage

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

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.updateServiceList und updateMask=serviceItems. Einzelne Dienste können nicht aktualisiert werden.

Im folgenden Beispiel werden Dienste mit einem StructuredServiceItem und einem FreeFormServiceItem festgelegt:

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