Journal des modifications

v4.9

Nouvelles fonctionnalités

MoreHours
Vous pouvez désormais définir MoreHours dans 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 désormais obsolètes dans l'API Google My Business. Pour en savoir plus, consultez le journal des modifications liées à l'abandon.
Posts CallToAction
Au deuxième trimestre 2021, les posts CallToAction contenant 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
Listez les réseaux d'assurances acceptés par les établissements. Plus de détails

Changements de comportement

ID des avis
Les ID d'avis ont été migrés vers 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 de l'appel de l'API. Toutefois, il est essentiel d'actualiser tous les ID d'avis stockés dans votre système dans les 30 jours, conformément à nos Règles, en appelant le point de terminaison listReviews.
Établissement de services de proximité à domicile
Au premier trimestre 2021, 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 mettre à jour les services proposés 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éfini 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 sur ces catégories uniquement. Plus de détails

v4.5 Info COVID-19 (2)

Nouvelles fonctionnalités

Type de post pour une alerte 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 et les réponses mises à jour concernant un établissement. 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 modification de l'é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 par 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

Open Date
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 fournissez des questions fréquentes sur 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
Lieux recommandés dans GoogleLocations
Affichez les établissements non revendiqués qui, selon Google, pourraient vous appartenir. Plus de détails
Signaler des problèmes liés à GoogleLocation
Signalez les problèmes que vous rencontrez avec les 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 ALIMENTS, 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

Changements de comportement

Notifications pour les comptes d'organisation et les groupes d'établissements
Les comptes configurés pour les notifications Pub/Sub recevront désormais aussi 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é avec 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 l'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 par un appel Locations.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 relatives à 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'auteur de l'avis
Les URL des photos de profil des contributeurs 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 entreprise, 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.
Imp. photo
Les photos peuvent désormais être importées directement via l'API en plus de l'importation via une URL existante.
Filtrage/Activation des notifications
Vous pouvez désormais filtrer les notifications à envoyer à des sujets Pub/Sub. À l'avenir, les notifications utiliseront ce mécanisme afin qu'elles soient activées au lieu d'être envoyées à tous les utilisateurs.
UPDATED_REVIEW notifications
Vous pouvez désormais vous abonner aux notifications en temps réel concernant des modifications 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 maintenant sublocality.

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

  • Auparavant, il était impossible de distinguer les copropriétaires de comptes et d'établissements des propriétaires principaux via l'API (tous apparaissaient 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'humain. Les utilisateurs doivent utiliser le service de catégories de l'API Google My Business pour obtenir des noms de catégories traduits et intelligibles.

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

  • Éléments du menu déroulant avec nom, description, prix et 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 qu'il crée en double 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, ce qui permet aux utilisateurs de 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 indique les établissements fermés définitivement 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 votre établissement 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 associez-les manuellement aux adresses de vos établissements.
Transférer l'é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 premier 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 d'établissement
Les états des é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 de format d'image.

Modifications avec incompatibilité ascendante

  • Vous ne pouvez désormais mettre à jour que les photos d'établissements disposant d'une page Google+ (auparavant, 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 uniquement des ID de catégorie lorsque vous définissez des catégories.

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

  • Les opérations create/update incluent désormais l'emplacement comme charge utile du corps. Les autres paramètres sont 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, où l'ID de la requête correspond à un établissement déjà créé, l'établissement existant est simplement renvoyé, ce qui évite de créer un doublon dans votre compte.

    • business_hours dans Location a été renommé regular_hours.