Outils Fiche d'établissement
Établissements, avis et réponses, posts, médias, mises à jour des catégories et des informations, statistiques de performances.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture11 outils
list_gbp_locations
Lecture1 créditsÉtablissements Google Business Profile (nom, téléphone, site web, horaires, catégorie, adresse, description) avec un audit des informations manquantes par établissement. Lecture seule.
Cet outil ne prend aucun paramètre.
list_gbp_reviews
Lecture1 créditsAvis d'un ou de tous les établissements sur les N derniers jours (note, texte, statut de réponse) plus la note moyenne. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
daysFacultatif | integer (1–365) | — |
min_ratingFacultatif | integer (1–5) | — |
max_ratingFacultatif | integer (1–5) | — |
unreplied_onlyFacultatif | boolean | — |
limitFacultatif | integer (1–200) | reviews read per location (default 50) |
summary_onlyFacultatif | boolean | only average rating, total and unanswered count |
offsetFacultatif | integer (0–…) | skip this many matching reviews per location |
draft_gbp_review_replies
Lecture2 créditsRédige des réponses courtoises aux avis sans réponse dont la note est inférieure ou égale à max_rating (3 étoiles par défaut). Rien n'est publié ; montrez les brouillons à l'utilisateur et appelez reply_gbp_review pour ceux qu'il approuve.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
daysFacultatif | integer (1–365) | — |
max_ratingFacultatif | integer (1–5) | — |
toneFacultatif | string | p. ex. 'kısa, resmi, özür dileyen' |
gbp_insights
Lecture1 créditsStatistiques de la fiche sur la période : impressions (recherche/maps), clics vers le site, appels, demandes d'itinéraire, conversations, réservations ; par établissement et totaux. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
daysFacultatif | integer (1–540) | — |
dailyFacultatif | boolean | — |
gbp_vs_ads
Lecture3 créditsVue locale côte à côte : statistiques Business Profile, dépenses/clics/conversions des campagnes locales Google Ads et clics organiques Search Console (requêtes de ville). Chaque source signale honnêtement si elle n'est pas connectée. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
cityFacultatif | string | — |
daysFacultatif | integer (1–540) | — |
list_gbp_media
Lecture1 créditsPhotos et vidéos d'un ou de tous les établissements Business Profile : catégorie d'emplacement (couverture, profil, extérieur, intérieur, équipe…), URL Google, taille, vues, plus un décompte par catégorie et les emplacements clés restés vides. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
categoryFacultatif | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
limitFacultatif | integer (1–500) | — |
gbp_location_details
Lecture1 créditsTout sur un établissement Business Profile : titre, adresse, téléphones, site web, description, catégories, horaires habituels, liste des services, lien Google Maps, place id et lien direct « rédiger un avis ». Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
services_limitFacultatif | integer (0–500) | — |
gbp_search_categories
Lecture1 créditsRecherche par nom dans la liste des catégories Business Profile de Google (p. ex. 'dentist') et renvoie les id de catégorie (categories/gcid:…) pour update_gbp_categories ou gbp_create_location. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | — |
regionFacultatif | string | pays à deux lettres, par défaut TR |
languageFacultatif | string | — |
limitFacultatif | integer (1–100) | — |
gbp_search_keywords
Lecture1 créditsTermes de recherche utilisés sur la recherche Google et Maps avant l'affichage de la fiche, avec les impressions mensuelles, pour un établissement. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
monthsFacultatif | integer (1–18) | mois complets en arrière à partir du mois dernier (par défaut 3) |
limitFacultatif | integer (1–500) | — |
offsetFacultatif | integer (0–…) | — |
include_low_volumeFacultatif | boolean | liste aussi les termes que Google indique seulement comme « moins de N » |
gbp_list_posts
Lecture1 créditsPublications locales déjà publiées sur un établissement Business Profile, des plus récentes aux plus anciennes : id, type, texte, état, incitation à l'action et lien. Utilisez l'id avec gbp_update_post ou gbp_delete_post. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
limitFacultatif | integer (1–100) | — |
gbp_verification_options
Lecture1 créditsMéthodes de validation proposées par Google pour une fiche (carte postale, appel, SMS, e-mail, instantanée), validations passées et en attente, et si le compte la gère déjà. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
languageFacultatif | string | — |
Outils d'écriture15 outils
update_gbp_location
Écriture2 créditsMet à jour le téléphone, le site web, les horaires habituels, les horaires spéciaux (jours fériés), la description ou le nom d'un établissement. L'aperçu montre le champ, l'ancienne et la nouvelle valeur ; appliqué uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
locationObligatoire | string | id d'établissement, locations/ID ou nom de l'établissement |
phoneFacultatif | string | — |
websiteFacultatif | string | — |
hoursFacultatif | object | {'pazartesi': '09:00-18:00', 'cumartesi': '10:00-14:00, 15:00-19:00', 'pazar': 'kapalı'} |
special_hoursFacultatif | array<object> | — |
descriptionFacultatif | string | — |
titleFacultatif | string | — |
additional_phonesFacultatif | array<string> | replaces the extra numbers (max 2); changing only phone keeps them |
clear_additional_phonesFacultatif | boolean | — |
address_linesFacultatif | array<string> | — |
cityFacultatif | string | — |
regionFacultatif | string | province / state |
postal_codeFacultatif | string | — |
countryFacultatif | string | two-letter country code, e.g. TR |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
reply_gbp_review
Écriture2 créditsPublie une réponse à un avis (texte dicté par l'utilisateur ou approuvé depuis draft_gbp_review_replies). Élément de validation ; rien n'est publié avant l'approbation.
| Paramètre | Type | Description |
|---|---|---|
locationObligatoire | string | id d'établissement, locations/ID ou nom de l'établissement |
review_idObligatoire | string | — |
replyObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_gbp_post
Écriture2 créditsPublie un post Business Profile (actualité, événement, offre ou alerte) sur tous les établissements ou une sélection. Aperçu d'abord ; publié uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
summaryObligatoire | string | — |
topic_typeFacultatif | STANDARD | EVENT | OFFER | ALERT | — |
cta_typeFacultatif | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlFacultatif | string | — |
image_urlFacultatif | string | — |
locationsFacultatif | array<string> | omettre pour tous les établissements |
languageFacultatif | string | — |
event_titleFacultatif | string | — |
start_dateFacultatif | string | — |
end_dateFacultatif | string | — |
coupon_codeFacultatif | string | — |
termsFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_gbp_categories
Écriture2 créditsModifie la catégorie principale et/ou les catégories supplémentaires d'un établissement. Les noms sont résolus selon la liste de catégories Google (un nom ambigu renvoie les candidats au lieu de deviner). L'aperçu montre les anciennes et nouvelles catégories ; appliqué uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
locationObligatoire | string | id d'établissement, locations/ID ou nom de l'établissement |
primary_categoryFacultatif | string | nom affiché de la catégorie (p. ex. 'Diş kliniği') ou id categories/gcid:… |
additional_categoriesFacultatif | array<string> | remplace toutes les catégories supplémentaires (9 max.) |
add_categoriesFacultatif | array<string> | — |
remove_categoriesFacultatif | array<string> | — |
regionFacultatif | string | pays à deux lettres pour la liste des catégories, TR par défaut |
languageFacultatif | string | langue des noms de catégories, celle de l'utilisateur par défaut |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_gbp_media
Écriture2 créditsAjoute une photo ou une vidéo depuis une URL publique à un ou plusieurs établissements Business Profile avec une catégorie d'emplacement (couverture, profil, extérieur, intérieur, produit, équipe…). Aperçu d'abord ; envoyé uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id d'établissement, locations/ID ou nom de l'établissement |
locationsFacultatif | array<string> | plusieurs établissements à la fois |
source_urlFacultatif | string | URL http(s) publique de la photo/vidéo ; Google la télécharge |
source_urlsFacultatif | array<string> | several photos/videos in one call |
media_formatFacultatif | PHOTO | VIDEO | — |
categoryFacultatif | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | emplacement ; COVER et PROFILE doivent être des photos |
descriptionFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
connect_business_profile
Écriture0 créditsLance la connexion de Google Business Profile : renvoie un lien d'autorisation à usage unique que l'utilisateur ouvre (même parcours que connect_account). Rien n'est connecté tant que l'utilisateur ne s'est pas identifié.
Cet outil ne prend aucun paramètre.
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_create_location
Écriture5 créditsCrée une NOUVELLE fiche Business Profile (une nouvelle entreprise sur Maps/Recherche). L'aperçu montre la fiche exacte ; elle n'est créée qu'après validation et doit encore être validée par Google (gbp_verification_options) avant d'apparaître.
| Paramètre | Type | Description |
|---|---|---|
titleObligatoire | string | — |
address_linesObligatoire | array<string> | — |
cityFacultatif | string | — |
regionFacultatif | string | — |
postal_codeFacultatif | string | — |
countryObligatoire | string | code pays à deux lettres, p. ex. TR |
primary_categoryObligatoire | string | nom de catégorie ou categories/gcid:… (gbp_search_categories) |
phoneFacultatif | string | — |
websiteFacultatif | string | — |
hoursFacultatif | object | {'pazartesi': '09:00-18:00', 'pazar': 'kapalı'} (jours de la semaine en turc) |
descriptionFacultatif | string | — |
accountFacultatif | string | compte Business Profile ; par défaut celui qui est connecté |
languageFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_start_verification
Écriture3 créditsLance la validation d'une fiche avec l'une des méthodes de gbp_verification_options. Élément de validation ; Google envoie ensuite un code, à saisir avec gbp_complete_verification.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
methodObligatoire | ADDRESS | EMAIL | PHONE_CALL | SMS | AUTO | — |
phoneFacultatif | string | pour PHONE_CALL / SMS |
emailFacultatif | string | pour EMAIL |
mailer_contactFacultatif | string | nom du destinataire de la carte postale (ADDRESS) |
languageFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_complete_verification
Écriture2 créditsTermine une validation en attente avec le code PIN envoyé par Google (carte postale, SMS, appel ou e-mail). Élément de validation ; le PIN est masqué dans l'aperçu.
| Paramètre | Type | Description |
|---|---|---|
verificationObligatoire | string | nom de la validation locations/…/verifications/… ou son id |
pinObligatoire | string | — |
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_manage_services
Écriture3 créditsAjoute, retire ou remplace des services dans la liste des Services d'un établissement (nom libre ou id de service prédéfini par Google, avec description et prix facultatifs). L'aperçu montre l'ancienne et la nouvelle liste ; appliqué uniquement après validation. La liste actuelle se trouve dans gbp_location_details.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
actionObligatoire | add | remove | replace | — |
servicesObligatoire | array<object> | — |
languageFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_social_links
Écriture2 créditsLit ou définit les liens de réseaux sociaux et de prise de rendez-vous d'un Business Profile (Instagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, WhatsApp, rendez-vous). Sans links/remove, il ne fait que lire ; les modifications ouvrent un élément de validation montrant les anciens et nouveaux liens.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
linksFacultatif | object | {platform: url} ; plateformes : instagram, facebook, twitter, linkedin, youtube, tiktok, pinterest, whatsapp, appointment |
removeFacultatif | array<string> | plateformes dont le lien est supprimé |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_update_post
Écriture3 créditsModifie sur place une publication Business Profile déjà publiée (texte et/ou bouton d'incitation à l'action) sans la supprimer. Aperçu d'abord ; appliqué uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
postObligatoire | string | id ou nom complet de la publication depuis gbp_list_posts |
summaryFacultatif | string | — |
cta_typeFacultatif | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_delete_post
ÉcritureIrréversible2 créditsSupprime DÉFINITIVEMENT une publication Business Profile. Jamais appliqué automatiquement : attend toujours la validation explicite de l'utilisateur.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
postObligatoire | string | id ou nom complet de la publication depuis gbp_list_posts |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_update_photo_category
Écriture2 créditsDéplace sur place une photo déjà présente sur le profil vers une autre catégorie d'emplacement (couverture, profil, extérieur, intérieur…), en conservant ses vues et son historique. Aperçu d'abord ; appliqué uniquement après validation.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
media_idObligatoire | string | media_key depuis list_gbp_media |
categoryObligatoire | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
gbp_delete_photo
ÉcritureIrréversible2 créditsSupprime DÉFINITIVEMENT une photo ou une vidéo d'un Business Profile. Jamais appliqué automatiquement : attend toujours la validation explicite de l'utilisateur.
| Paramètre | Type | Description |
|---|---|---|
locationFacultatif | string | id de l'établissement, locations/ID ou titre ; omettez-le pour utiliser l'établissement sélectionné (ou le seul) |
media_idObligatoire | string | media_key depuis list_gbp_media |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.