Création et modification des données sur les établissements avec l’API Google My Business Business Information

L’API Google My Business Business Information permet de créer et de modifier les données sur les établissements d’une entreprise. Vous pouvez effectuer plusieurs actions telles que la création d’un établissement, la suppression d’un établissement, l’obtention d’un établissement par son nom, la liste des emplacements, l’application d’un correctif à un établissement, etc. Dans ce tutoriel, nous allons détailler chaque action.

Avant de commencer

Avant d’utiliser l’API Google My Business Business Information, vous devez enregistrer votre application et obtenir des identifiants OAuth 2.0. Pour en savoir plus sur la configuration de base, consultez la documentation.

Créer un établissement

L’API My Business Business Information permet de créer un établissement pour une entreprise à l’aide de la méthode accounts.locations.create. Pour créer un établissement, vous devez fournir les informations suivantes :

• storeCode : Le code de l’établissement
• languageCode : Le code de langue (par exemple, « en-AU » pour l’anglais australien)
• title : Le nom de l’établissement
• phoneNumbers : Les numéros de téléphone de l’établissement
• storefrontAddress : L’adresse de l’établissement
• websiteUri : L’URL du site web de l’établissement
• regularHours : Les heures d’ouverture régulières de l’établissement
• categories : Les catégories de l’établissement

Voici un exemple de requête pour créer un établissement :

« `
POST https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?requestId=requestId&validateOnly=True|False

{
« storeCode »: « GOOG-SYD »,
« languageCode »: « en-AU »,
« title »: « Google Sydney »,
« phoneNumbers »: {
« primaryPhone »: « 02 9374 4000 »
},
« storefrontAddress »: {
« addressLines »: [
« Level 5 »,
« 48 Pirrama Road »
],
« locality »: « Pyrmont »,
« postalCode »: « 2009 »,
« administrativeArea »: « NSW »,
« regionCode »: « AU »
},
« websiteUri »: « https://www.google.com.au/ »,
« regularHours »: {
« periods »: [
{
« openDay »: « MONDAY »,
« closeDay »: « MONDAY »,
« openTime »: « 09:00 »,
« closeTime »: « 17:00 »
},
{
« openDay »: « TUESDAY »,
« closeDay »: « TUESDAY »,
« openTime »: « 09:00 »,
« closeTime »: « 17:00 »
},
{
« openDay »: « WEDNESDAY »,
« closeDay »: « WEDNESDAY »,
« openTime »: « 09:00 »,
« closeTime »: « 17:00 »
},
{
« openDay »: « THURSDAY »,
« closeDay »: « THURSDAY »,
« openTime »: « 09:00 »,
« closeTime »: « 17:00 »
},
{
« openDay »: « FRIDAY »,
« closeDay »: « FRIDAY »,
« openTime »: « 09:00 »,
« closeTime »: « 17:00 »
}
] },
« categories »: {
« primaryCategory »: {
« name »: « gcid:software_company »
}
}
}
« `

Supprimer un établissement

L’API My Business Business Information permet de supprimer un établissement à l’aide de la méthode locations.delete. Pour supprimer un établissement, vous devez spécifier l’ID de l’établissement que vous souhaitez supprimer. Voici un exemple de requête pour supprimer un établissement :

DELETE https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

Obtenir un établissement par son nom

L’API My Business Business Information permet d’obtenir un établissement spécifique en filtrant par nom d’entreprise à l’aide de la méthode locations.get. Pour obtenir un établissement par son nom, vous devez spécifier l’ID de l’établissement ainsi qu’une liste de champs à récupérer. Voici un exemple de requête pour obtenir un établissement par son nom :

GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask={commaSeparatedFieldsToRetrieve}

Répertorier les emplacements

Si vous gérez un ou plusieurs établissements, vous pouvez lister tous les établissements associés à votre compte à l’aide de la méthode accounts.locations.list. Pour répertorier tous les établissements, vous devez spécifier l’ID du compte ainsi qu’une liste de champs à récupérer. Voici un exemple de requête pour répertorier tous les établissements :

GET https://mybusinessbusinessinformation.googleapis.com/v1/accounts/{accountId}/locations?readMask={commaSeparatedFieldsToRetrieve}

Appliquer un correctif à un établissement

L’API My Business Business Information permet de mettre à jour un ou plusieurs champs d’un établissement à l’aide de la méthode locations.patch. Pour appliquer un correctif à un établissement, vous devez spécifier l’ID de l’établissement ainsi qu’une liste de champs à mettre à jour. Voici un exemple de requête pour appliquer un correctif à un établissement :

« `
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

{
« updateMask »: « storeCode,title,phoneNumbers.primaryPhone »
// Champs à mettre à jour
}
« `

Voilà ! Vous savez maintenant comment créer et modifier les données sur les établissements à l’aide de l’API Google My Business Business Information. N’hésitez pas à consulter la documentation officielle pour plus de détails sur les différentes méthodes disponibles.