Journal des modifications

v4.9

Nouvelles fonctionnalités

MoreHours
Vous pouvez maintenant définir
MoreHours via la fiche d'établissement.
Vous pouvez récupérer MoreHourTypes pour chaque catégorie à l'aide de categories.batchGet.

Changements de comportement

Abandon des comptes v4.x
accounts, accounts.admins, accounts.invitations et accounts.locations.admins sont maintenant obsolètes dans l'API Google My Business. Pour en savoir plus, consultez le planning d'abandon.
Posts CallToAction
Au deuxième trimestre 2021, les posts CallToAction avec un ActionType GET_OFFER ne seront plus valides.

v4.8

Nouvelles fonctionnalités

Services d'hébergement
Récupération et mise à jour des services d'hébergement. Plus de détails
Ajout du point de terminaison GetGoogleUpdated pour l'hébergement
Ajout de la valeur booléenne canOperateLodgingData dans LocationState
Attributs de professionnels de santé
Récupération et mise à jour des HealthProviderAttributes. Plus de détails
Ajout de la valeur booléenne canOperateHealthData dans LocationState
Réseaux d'assurances
Répertoriez les réseaux d'assurances acceptés par les établissements. Plus de détails

Changements de comportement

ID d'avis
Les ID d'avis sont passés à un nouveau format. Ce nouvel ID sera désormais renvoyé dans toutes les réponses d'API applicables. Pendant une courte période, les anciens ID d'avis seront toujours résolus lors d'un appel à l'API, mais vous devez impérativement actualiser tous les ID d'avis stockés dans votre système au cours des 30 prochains jours, conformément à nos Règles. Pour cela, vous devez appeler le point de terminaison listReviews.
Établissement de services de proximité à domicile
À partir du premier trimestre de 2021, l'élément Address ne sera plus renvoyé dans l'objet Location pour les établissements CUSTOMER_LOCATION_ONLY.

v4.7

Nouvelles fonctionnalités

Menus
Récupération et mise à jour de FoodMenus. Plus de détails

v4.6

Nouvelles fonctionnalités

Listes de services
Vous pouvez désormais récupérer et modifier les services fournis par un établissement. Plus de détails
Ajout de la valeur booléenne canModifyServiceList dans LocationState
Indique si un établissement remplit les conditions requises pour modifier des listes de services. Plus de détails
ServiceTypes prédéfinis pour les catégories
Les types de service prédéfinis sont désormais inclus dans l'objet de catégories. Plus de détails
CategoryView
Possibilité de spécifier une vue BASIC ou FULL pour les catégories. La vue FULL renvoie des détails supplémentaires, tels que les types de services. Plus de détails
Méthode Categories.BatchGet
Cette nouvelle méthode vous permet de saisir une liste de catégories et de renvoyer des informations seulement sur ces catégories. Plus de détails

v4.5 Info COVID-19 (2)

Nouvelles fonctionnalités

Type de post pour les alertes portant sur la COVID-19
Vous pouvez désormais créer un post COVID_19 via l'API. Plus de détails

v4.5 Info COVID-19 (1)

Nouvelles fonctionnalités

Fermé temporairement
Vous pouvez désormais définir un établissement sur CLOSED_TEMPORARILY via l'API. Plus de détails

v4.5

Nouvelles fonctionnalités

Pub/Sub pour les questions/réponses
Vous pouvez désormais recevoir des notifications Google Cloud Pub/Sub pour les nouvelles questions/réponses sur un établissement et celles qui ont été modifiées. Plus de détails
Pub/Sub pour l'état de la fiche
Vous pouvez désormais recevoir des notifications Google Cloud Pub/Sub en cas de changement d'état d'une fiche. Plus de détails

v4.4

Nouvelles fonctionnalités

Validation des établissements Local Services
Les établissements Local Services peuvent désormais être validés via l'API. Plus de détails
Nombre d'abonnés
Vous pouvez désormais récupérer les métadonnées concernant les abonnés. Plus de détails
Groupes d'utilisateurs et groupes d'établissements
Vous pouvez désormais créer des groupes d'utilisateurs et d'établissements via l'API. Plus de détails
Ajout du champ hasPendingEdits dans LocationState
Indique si les propriétés d'un établissement sont en attente de modification. Plus de détails

Nouveaux comportements

Date d'ouverture
Vous pouvez désormais définir une date d'ouverture dans le futur pour une fiche.
PointRadius
PointRadius est désormais en lecture seule. Pour modifier ou créer un établissement proposant des services de proximité, vous devez utiliser Places.

v4.3

Nouvelles fonctionnalités

API Questions and Answers
Récupérez vos questions, publiez des réponses et proposez une section avec des questions fréquentes pour vos établissements. Plus de détails
Regrouper les avis à lire
Récupérez les avis de plusieurs établissements via le même appel. Plus de détails
Établissements GoogleLocations recommandés
Affichez les établissements non revendiqués qui, selon Google, pourraient vous appartenir. Plus de détails
Signaler des problèmes liés à GoogleLocation
Signalez des problèmes à l'aide de résultats RecommendedGoogleLocations ou GoogleLocations. Plus de détails
Énumération des services pour les sections PriceList
Identifiez une section PriceList comme contenant soit des produits alimentaires (FOOD), soit des SERVICES fournis. Plus de détails
Description des contenus multimédias
Ajoutez une légende lorsque vous importez de nouveaux contenus multimédias. Plus de détails
Insights CHAINS_QUERIES
Récupérez le nombre de fois où un établissement a été affiché suite à une recherche sur la chaîne à laquelle il appartient. Plus de détails

Nouveaux comportements

Notifications pour les comptes d'organisation et les groupes d'établissements
Les comptes configurés pour les notifications Pub/Sub recevront désormais également ces notifications pour toutes les fiches contenues dans un compte d'organisation ou dans des groupes d'établissements pour lesquels ils ont des droits d'administrateur.
ListLocations pour le compte d'organisation et les groupes d'établissements
accounts.locations.list appelé via un groupe d'utilisateurs ou un compte d'organisation affiche désormais tous les établissements auxquels ce compte a accès.

v4.2

Nouvelles fonctionnalités

API Verification
Listez et déclenchez les méthodes de validation disponibles pour les établissements non validés. Plus de détails
API GoogleLocations
Recherchez des établissements existants sur Google à revendiquer ou récupérez un lien pour demander des droits d'accès à des établissements revendiqués. Plus de détails
Options de filtrage étendues
Options supplémentaires permettant de limiter les résultats renvoyés via un appel Location.List. Plus de détails
Appartenance à une chaîne
Indiquez l'appartenance d'un établissement à une chaîne (par exemple, Walmart, Target, etc.). Plus de détails
Informations sur l'organisation
Les informations sur les comptes d'organisation s'affichent désormais dans les objets "Account". Plus de détails
Photo du profil de l'utilisateur chargé de l'examen
Les URL des photos de profil des utilisateurs chargés de l'examen sont désormais incluses dans l'objet de l'avis. Plus de détails

v4.1

Nouvelles fonctionnalités

Contenus multimédias fournis par le client
Vous pouvez désormais récupérer et afficher des insights sur les photos et les vidéos générées par les utilisateurs pour les établissements que vous possédez et gérez. Plus de détails
API Admin Management
Vous pouvez désormais répertorier, accepter et refuser des invitations pour des comptes et des établissements dans votre compte. Plus de détails
Profile (Description fournie par le marchand)
Utilisez vos propres mots pour décrire votre établissement, et partagez avec les utilisateurs l'histoire unique de votre entreprise et des produits ou services que vous proposez. Plus de détails
Champ openingDate
Indiquez la date d'ouverture de votre établissement. Plus de détails
Posts pour des types d'offres
Nouveau type de post sur Google pour aider les utilisateurs à trouver des offres spéciales dans vos établissements. Plus de détails

v4

Nouvelles fonctionnalités

Posts sur Google
Vous pouvez désormais créer des posts sur Google directement via l'API.
Importation de photos
Les photos peuvent désormais être importées directement via l'API en plus de la méthode existante via une URL.
Filtrage/Activation des notifications
Vous pouvez désormais filtrer les notifications à envoyer à des thèmes Pub/Sub. À l'avenir, les notifications utiliseront ce mécanisme. Ainsi, elles ne seront plus envoyées à tous les utilisateurs, mais seulement à ceux qui les active.
Notifications UPDATED_REVIEW
Vous pouvez désormais vous abonner aux notifications en temps réel concernant des mises à jour apportées aux avis des clients.
Compatibilité avec les groupes d'utilisateurs
L'API Google My Business est désormais compatible avec les comptes de type "Groupe d'utilisateurs".

Modifications avec incompatibilité ascendante

  • Les photos, qui étaient auparavant un champ d'objets location, sont désormais une ressource sous "location" (accounts/account_ID/locations/location_ID/photos).

  • Le champ d'adresse Country est désormais region_code et sub_locality est désormais sublocality.

  • Le champ Ownership, qui était obsolète, a maintenant été supprimé.

  • Auparavant, les copropriétaires de comptes et d'établissements ne pouvaient pas être distingués des propriétaires principaux via l'API (tous étaient affichés en tant que OWNER). Les propriétaires principaux se voient désormais attribuer le rôle OWNER et les autres propriétaires se voient attribuer le rôle CO_OWNER.

  • AccountType.BUSINESS s'appelle désormais AccountType.LOCATION_GROUP.

  • Lorsque vous utilisez un masque de champ pour mettre à jour des établissements, indiquez update_mask à la place de field_mask.

  • Le message de catégorie utilisé pour primary_category et additional_categories ne contient plus de format lisible par l'utilisateur. Ce dernier peut obtenir des noms de catégories traduites et lisibles en utilisant le service catégories de l'API Google My Business.

v3.3

Nouvelles fonctionnalités

Menus structurés

Vous pouvez désormais ajouter, mettre à jour ou supprimer :

  • Plusieurs menus pour un même établissement

  • Inclure plusieurs sections de menu dans un menu

  • Répertorier les éléments de menus avec leur nom, leur description, les prix et les photos

v3.2

Nouvelles fonctionnalités

Insights
Vous pouvez désormais récupérer des insights sur les établissements et générer des métriques via l'API.
Notifications
Vous pouvez désormais vous abonner aux notifications en temps réel concernant les nouvelles mises à jour Google.

Modifications avec incompatibilité ascendante

  • Les champs languageCodes et platforms de UrlAttributeValue, précédemment non utilisés, ont été supprimés.

  • SAME, dans l'énumération obsolète "Ownership", ne s'applique désormais que si l'établissement, dont celui-ci est un doublon, est associé au même propriétaire principal. Auparavant, le comportement était basé sur un calcul de propriété plus complexe.

v3.1

Nouvelles fonctionnalités

Notifications
Vous pouvez désormais vous abonner aux notifications en temps réel concernant de nouveaux avis.
URL Maps
Les URL Google Maps sont incluses dans les réponses sur les établissements afin que les utilisateurs puissent créer facilement un lien vers Google Maps.
États des établissements
États supplémentaires indiquant quand la fiche est publiée, désactivée et en attente de validation
Indicateur de réouverture
L'indicateur canReopen affiche les établissements définitivement fermés qui peuvent être rouverts par rapport à ceux qui ne le peuvent pas.
Attributs
Compatibilité avec les attributs URL et Enum.
Point de terminaison de catégorie
Obtenez une liste de catégories acceptées par pays et langue (remplace les fichiers CSV).

v3

Nouvelles fonctionnalités

Avis
Vous pouvez désormais récupérer les avis sur les établissements et y répondre via l'API.
Attributs
Fournissez des informations supplémentaires sur les établissements, spécifiques à leur catégorie.
Rechercher une adresse correspondante
Recherchez des adresses existantes sur la carte et et associez-les manuellement aux adresses de vos établissements.
Transférer un établissement
Nouvelle action sur Location :transfer. Permet de transférer un établissement d'un compte (professionnel ou personnel) à un autre.
Photo préférée
Indiquez la photo que vous souhaitez afficher en priorité sur Google Maps et dans la recherche Google.
Nouveaux filtres de recherche
Les nouveaux filtres de recherche incluent any_google_updates, is_suspended et is_duplicate.
Nouveaux états pour les établissements
Les états associés aux établissements incluent désormais is_verified et needs_reverification.
Améliorations apportées aux URL des photos
L'API accepte désormais les URL de photos sans suffixe ajouté au format de l'image.

Modifications avec incompatibilité ascendante

  • Vous ne pouvez désormais mettre à jour que les photos d'établissements disposant d'une page Google+ (au préalable, celles-ci étaient acceptées et supprimées en mode silencieux).

  • Les champs location_name et category_name sont désormais au format sortie seulement. Utilisez seulement des ID de catégorie lorsque vous définissez des catégories.

  • Les masques de champs ne doivent plus comprendre le préfixe location. pour les champs inclus.

  • Les opérations create/update incluent désormais l'établissement comme charge utile du corps. Les autres paramètres ont été déplacés vers la chaîne de requête.

v2

Modifications avec incompatibilité ascendante

  • Vous devez maintenant spécifier un request_id dans les appels CreateLocation. Cet ID doit être unique pour chaque établissement. Cela permet d'éviter la création d'établissements en double dans votre compte. Lorsque vous essayez de créer un établissement et que l'ID de la requête correspond à un établissement déjà créé, l'établissement existant est simplement renvoyé, ce qui évite de générer un doublon dans votre compte.

    • business_hours dans location s'appelle désormais regular_hours.