Important : La version 4.8 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Ajouter des services

Les établissements peuvent ajouter les services qu'ils proposent à leurs fiches Google My Business. Il peut s'agir de services proposés dans un magasin ou chez les clients.

Éligibilité et format

Seuls certains établissements peuvent ajouter des services à leur fiche Google My Business. Pour savoir si le vôtre en fait partie, vérifiez l'état de canModifyServiceList dans LocationState.

Un service est représenté sous forme de ServiceItem, qui est compatible avec les deux formats suivants :

  • StructuredServiceItem : les services prédéfinis de Google peuvent être représentés sous forme de StructuredServiceItem, qui contient un serviceTypeId.
  • FreeFormServiceItem : pour proposer des services personnalisés, utilisez un objet FreeFormServiceItem contenant un Libellé.

Répertorier des services prédéfinis par nom de catégorie

Pour rechercher des services prédéfinis sous une catégorie par nom de catégorie, utilisez categories.list. Vous trouverez une requête pour toutes les catégories qui inclut le nom salon à Singapour dans la section "Requête" ci-dessous.

Requête

La propriété CategoryView doit être définie sur FULL.

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

Réponse

La réponse partielle suivante renvoie tous les ServiceTypes acceptés.

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

Répertorier les services prédéfinis par ID de catégorie

Pour rechercher des services prédéfinis en fonction d'un ID de catégorie spécifique, utilisez categories.batchGet. Vous trouverez une requête d'informations pour l'ID de catégorie gcid:electrician aux États-Unis dans la section "Requête" ci-dessous.

Requête

La propriété CategoryView doit être définie sur FULL.

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

Réponse

La réponse contient tous les ServiceTypes acceptés pour 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"
                }
            ]
        }
    ]
}

Répertorier les services existants dans une fiche

Pour obtenir la liste actuelle des services, utilisez locations.getServiceList.

Requête

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

Réponse

Vous trouverez ci-dessous un exemple de réponse.

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

Définir les services d'une fiche

Pour mettre à jour des services, utilisez locations.updateServiceList et updateMask=serviceItems. Il n'est pas possible de mettre à jour des services individuels.

Pour définir des services avec un élément StructuredServiceItem et un élément FreeFormServiceItem, consultez l'exemple suivant :

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