Mettre à jour un établissement

Met à jour un seul établissement. Seuls les champs présents dans input sont modifiés ; tous ceux que vous omettez conservent leur valeur actuelle. id est le seul champ obligatoire.

Cas d’utilisation : corriger un numéro de téléphone. Envoyez uniquement id et phone pour corriger les coordonnées sans modifier l’adresse ni les horaires. La réponse renvoie l’établissement mis à jour pour que vous puissiez confirmer que les nouvelles valeurs ont été enregistrées.

Cas d’utilisation : publier un planning hebdomadaire complet. Envoyez le tableau businessHours couvrant les sept jours (comme dans l’exemple de requête) pour définir les plages d’ouverture de chaque jour. Indiquez les jours de fermeture avec { "day": "SUNDAY", "type": "CLOSED", "slots": [] }.

Règles relatives aux horaires d’ouverture.

• Fournissez les sept jours ; une semaine incomplète est rejetée.
• Les heures utilisent start/end dans chaque entrée slots (e.g, 09:00am, 05:00pm) ; les plages horaires d’une même journée ne doivent pas se chevaucher.
• Les dérogations pour les jours fériés et les événements sont des entrées supplémentaires contenant day: "SPECIAL" et un specialDate (YYYY-MM-DD), envoyées avec les sept entrées correspondant aux jours de la semaine, jamais à leur place.
• Utilisez SPECIAL uniquement dans businessHours. Les entrées moreHours n’ont pas de champ specialDate ; un jour SPECIAL dans ces entrées n’est donc associé à aucune date.
• Utilisez moreHours pour les horaires secondaires (livraison, service au volant), avec hoursTypeId comme clé.

Envoyez toujours la semaine complète. Les plateformes de publication attendent un planning complet de MONDAY à SUNDAY ; envoyez les sept entrées chaque fois que vous définissez businessHours, en utilisant type: "CLOSED" (avec slots vide) pour les jours de fermeture plutôt que d’omettre le jour.

Points d’attention.

• Le champ d’identifiant est id (l’identifiant Relay en Base64 renvoyé par chaque endpoint de lecture).
• En cas d’échec de validation, l’appel renvoie tout de même HTTP 200 avec success: false et un tableau errors renseigné ; vérifiez toujours success, pas seulement le code de statut.

Liens d’action de l’établissement

placeActionLinks gère les boutons d’action Google d’un établissement (commande, livraison, vente à emporter, réservation, prise de rendez-vous). Le modèle d’écriture est append/upsert, et non un remplacement :

• action: "add" (par défaut) : ajoute un nouveau lien ou met à jour sur place les champs uri/isPreferred d’un lien enregistré.
• action: "delete" : supprime un lien enregistré et met sa suppression de Google en file d’attente.
• Les liens que vous ne référencez pas dans la requête sont laissés inchangés ; omettre un lien ne le supprime jamais.

Comment un lien est identifié (pour modification ou suppression) : par name s’il est présent, sinon par placeActionType + uri. Incluez name (obtenu via un endpoint de lecture) lorsque vous en disposez, pour une correspondance aussi précise que possible ; un lien qui n’a pas encore été synchronisé avec Google n’a pas de name et est identifié par placeActionType + uri.

Valeurs valides pour placeActionType : APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE. Au maximum un lien préféré par type.

Modifier l’URL d’un lien = supprimer l’ancien + ajouter le nouveau dans la même requête :

{  "input": {    "id": "TG9jYXRpb246MTgwMDI4OQ==",    "placeActionLinks": [      { "placeActionType": "FOOD_ORDERING", "uri": "https://order.example.com",     "name": "<link-name-if-synced>", "action": "delete" },      { "placeActionType": "FOOD_ORDERING", "uri": "https://new-order.example.com", "isPreferred": true, "action": "add" }    ]  }}

Juste après une écriture, les champs name et submissionStatus d’un lien valent null ; ils sont renseignés une fois le lien synchronisé avec Google. Consultez le guide des liens d’action de l’établissement pour connaître le processus complet, notamment la manière dont les liens découverts directement sur Google apparaissent sous discoveredPlaceActionLinks.