Important : La version 4.7 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.

Journal des modifications

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 "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 le 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 questions/réponses nouvelles ou 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 changement d'état d'une fiche. Plus de détails

v4.4

Nouvelles fonctionnalités

Validation des établissements proposant des services de proximité
Les établissements proposant des services de proximité 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 pour les questions/réponses
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 de validation
Répertoriez 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, E.Leclerc, Picard, 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
Posts concernant des produits
Nouveau type de post local contenant du contenu lié aux produits (nom, prix, etc.). 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 statistiques 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 de gestion des tâches administratives
Vous pouvez désormais répertorier, accepter et refuser des invitations pour des comptes et des établissements sur 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. Des tentatives de création d'un établissement, où l'ID de la requête correspond à un établissement précédemment créé, renvoient simplement l'établissement existant, évitant ainsi de créer un doublon dans votre compte.

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