Configurer les tâches Google My Business Info en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches Google My Business Info en temps réel
Un Google Business Profile : nom, adresse, téléphone, horaires, note, catégorie et les attributs affichés par Google dans le panneau. Enveloppé dans l'enveloppe DataForSEO : données dans tasks[0].result, résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Le jumeau en file d'attente est post_dataforseo_business_google_gmb_info_submit. Pour ce que le propriétaire a publié récemment, utilisez post_dataforseo_business_google_gmb_updates_submit, et pour l'avis des clients, post_dataforseo_business_google_reviews_submit.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.0054.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- keywordType: string
mot-clé
champ obligatoire
le mot-clé que vous spécifiez doit indiquer le nom de l'établissement local
vous pouvez spécifier jusqu'à 700 caractères dans le champkeyword
tous les %## seront décodés (le caractère ‘+’ sera décodé en espace)
si vous devez utiliser le caractère “%” dans votrekeyword, spécifiez-le comme “%25” ;ce champ peut aussi servir à transmettre les paramètres suivants :
cid- un id unique de l'entité commerciale, défini par Google ;place_id- un identifiant de l'entité commerciale dans Google Maps ;exemple :
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Aen savoir plus sur les identifiants
cidetplace_iddans cet article du centre d'aideen savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - languageType: string
_code code de langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_name
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_name
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/languages
exemple :en - languageType: string
_name nom complet de la langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_code
vous pouvez obtenir la liste des langues disponibles aveclanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/languages
exemple :English - locationType: integer
_code code de localisation du moteur de recherche
champ obligatoire si vous n'indiquez paslocation_nameoulocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin d'indiquerlocation_nameoulocation_coordinate
vous pouvez obtenir la liste des localisations disponibles aveclocation_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/business_data/google/locations
exemple :2840 - locationType: string
_coordinate coordonnées GPS d'un emplacement
champ obligatoire si vous ne spécifiez paslocation_name_orlocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_nameoulocation_code
le paramètrelocation_coordinatedoit être spécifié au format "latitude,longitude,radius"
nombre maximal de décimales pour "latitude" et "longitude" : 7
valeur minimale pour "radius" : 199.9 (mm)
valeur maximale pour "radius" : 199999 (mm)
exemple :53.476225,-2.243572,200 - locationType: string
_name nom complet de l'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_codeoulocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_codeoulocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles aveclocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/locations
exemple :London,England,United Kingdom - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis - datetimeType: string | null
date et heure de réception du résultat
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - itemType: array (string | null)[] | null
_types types d'éléments
types de résultats de recherche trouvés dans le tableauitems;
types d'éléments possibles :google_business_info - itemsType: array (object | null)[] | null
types d'éléments rencontrés
types de résultats de recherche trouvés dans le tableauitems;
types d'éléments possibles :google_business_info- additionalType: array string[] | null
_categories catégories d'entreprise supplémentaires
catégories Google My Business supplémentaires qui décrivent plus en détail les services fournis par l'entité commerciale - addressType: string | null
adresse de l'entité commerciale
- addressType: object | null · Response36Afe1097B20_AddressInfo
_info objet contenant les composants d'adresse de l'entité commerciale
- addressType: string | null
adresse de l'établissement local
- boroughType: string | null
unité administrative ou district auquel appartient l'établissement local
- cityType: string | null
nom de la ville où se trouve l'établissement local
- countryType: string | null
_code code ISO du pays de l'établissement local
- regionType: string | null
région DMA à laquelle appartient l'établissement local
- zipType: string | null
code postal de l'établissement local
- attributesType: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
détails du service sous forme de vérifications évaluées par les utilisateurs ;
détails du service d'une entité commerciale affichés sous forme de vérifications et basés sur les retours des utilisateurs et lacategoryde l'entreprise- availableType: object | null
_attributes attributs disponibles
indique les attributs qu'une entité commerciale peut proposer- propertyType: array (string | null)[] | null
Name
- unavailableType: object | null
_attributes attributs indisponibles
indique les attributs qu'une entité commerciale ne peut pas proposer- propertyType: array (string | null)[] | null
Name
- bookType: string | null
_online _url URL du bouton 'réserver en ligne' de l'élément
URL dirigeant les utilisateurs vers la page de réservation ou de commande en ligne de l'entité commerciale - categoryType: string | null
catégorie d'entreprise
catégorie générale Google My Business qui décrit le mieux les services fournis par l'entité commerciale - categoryType: array string[] | null
_ids ID de catégorie globaux
ID de catégorie universels qui ne changent pas selon le pays sélectionné - cidType: string | null
- contactType: string | null
_url URL de la page de contact préférée
- contributorType: string | null
_url URL du profil Local Guides de l'utilisateur ou de l'entité, si disponible
- descriptionType: string | null
description de l'élément dans la SERP
la description de l'entité commerciale pour laquelle les résultats sont collectés - directoryType: object | null · Response36Afe1097B20_BusinessDirectoryInfo
éléments du répertoire
inclut des informations sur les entreprises situées dans l'établissement commercial cible et ayant la même adresse- itemsType: array (object | null)[] | null
types d'éléments rencontrés
types de résultats de recherche trouvés dans le tableauitems;
types d'éléments possibles :google_business_info- additionalType: array string[] | null
_categories catégories d'entreprise supplémentaires
catégories Google My Business supplémentaires qui décrivent plus en détail les services fournis par l'entité commerciale - addressType: string | null
adresse de l'entité commerciale
- addressType: object | null · Response36Afe1097B20_AddressInfo
_info objet contenant les composants d'adresse de l'entité commerciale
- addressType: string | null
adresse de l'établissement local
- boroughType: string | null
unité administrative ou district auquel appartient l'établissement local
- cityType: string | null
nom de la ville où se trouve l'établissement local
- countryType: string | null
_code code ISO du pays de l'établissement local
- regionType: string | null
région DMA à laquelle appartient l'établissement local
- zipType: string | null
code postal de l'établissement local
- categoryType: string | null
catégorie d'entreprise
catégorie générale Google My Business qui décrit le mieux les services fournis par l'entité commerciale - categoryType: array string[] | null
_ids ID de catégorie globaux
ID de catégorie universels qui ne changent pas selon le pays sélectionné - cidType: string | null
- domainType: string | null
domaine de l'entité commerciale
- featureType: string | null
_id - hotelType: string | null
_rating - isType: boolean | null
_claimed indique si l'entité est vérifiée par son propriétaire sur Google Maps
- isType: boolean | null
_directory _item l'établissement commercial fait partie du répertoire
indique si l'établissement commercial fait partie du répertoire ;
sitrue, l'élément fait partie d'un répertoire plus large d'entreprises ayant la même adresse (par exemple, un centre commercial) ;
remarque : si l'établissement commercial est un élément parent du répertoire, la valeur seranull - latitudeType: number | null
coordonnée de latitude des établissements locaux dans google maps
exemple :"latitude": 51.584091 - localType: array string[] | null
_justifications justifications locales Google
extraits de texte qui « justifient » la présence de l'entreprise pour la requête de recherche - longitudeType: number | null
coordonnée de longitude de l'établissement local dans google maps
exemple :"longitude": -0.31365919999999997 - mainType: string | null
_image URL de l'image principale présentée dans le profil Google My Business
- phoneType: string | null
numéro de téléphone de l'entité commerciale
- placeType: string | null
_id identifiant unique du lieu
place id de l'établissement local présenté dans l'élément
en savoir plus sur l'identifiant dans cet article du centre d'aide - priceType: string | null
_level niveau de prix de l'établissement
peut prendre les valeurs :inexpensive,moderate,expensive,very_expensive
s'il n'y a pas d'informations sur le niveau de prix, la valeur seranull - rankType: integer | null
_absolute rang absolu parmi tous les éléments
- rankType: integer | null
_group position au sein d'un groupe d'éléments ayant des valeurs
typeidentiques
les positions des éléments ayant des valeurstypedifférentes sont omises derank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- ratingType: object | null
_distribution la répartition des notes de l'entité commerciale l'objet affiche le nombre de notes de 1 à 5 étoiles, telles qu'évaluées par les utilisateurs
- propertyType: integer | null Format: Int64
Name
- snippetType: string | null
informations supplémentaires sur l'entité commerciale
- titleType: string | null
titre du répertoire
peut prendre les valeurs suivantes :At this place,Directory - totalType: string | null Format: int64
_photos nombre total d'images présentées dans le profil Google My Business
- typeType: string | null
type d'élément
- urlType: string | null
URL pour consulter le menu
- workType: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours horaires d'ouverture
informations sur les horaires de travail de l'établissement local- workType: object | null · Response36Afe1097B20_WorkHours
_hours horaires d'ouverture
informations sur les horaires de travail de l'établissement local- currentType: string | null
_status statut actuel de l'établissement
indique si l'établissement est ouvert ou fermé - timetableType: object | null
tableau des horaires d'ouverture
- propertyType: array (object | null)[] | null
Name horaires d'ouverture le dimanche
- closeType: object | null · Response36Afe1097B20_TimeInfo
heure de fermeture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- openType: object | null · Response36Afe1097B20_TimeInfo
heure d'ouverture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- titleType: string | null
titre de l'élément
domaine du système de menu en ligne
- domainType: string | null
domaine de l'entité commerciale
- featureType: string | null
_id - hotelType: number | null
_rating - isType: boolean | null
_claimed indique si l'entité est vérifiée par son propriétaire sur Google Maps
- isType: boolean | null
_directory _item l'établissement commercial fait partie du répertoire
indique si l'établissement commercial fait partie du répertoire ;
sitrue, l'élément fait partie d'un répertoire plus large d'entreprises ayant la même adresse (par exemple, un centre commercial) ;
remarque : si l'établissement commercial est un élément parent du répertoire, la valeur seranull - latitudeType: number | null
coordonnée de latitude des établissements locaux dans google maps
exemple :"latitude": 51.584091 - localType: array (object | null)[] | null
_business _links interactions disponibles avec l'entreprise
liste des options permettant d'interagir avec l'entreprise directement depuis les résultats de recherche- typeType: string | null
type d'élément
- logoType: string | null
URL du logo présenté dans le profil Google My Business
- longitudeType: number | null
coordonnée de longitude de l'établissement local dans google maps
exemple :"longitude": -0.31365919999999997 - mainType: string | null
_image URL de l'image principale présentée dans le profil Google My Business
- originalType: string | null
_title titre d'origine de l'élément
titre d'origine non traduit par Google - peopleType: array (object | null)[] | null
_also _search entités commerciales associées
- cidType: string | null
- featureType: string | null
_id - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés
- phoneType: string | null
numéro de téléphone de l'entité commerciale
- placeType: string | null
_id identifiant unique du lieu
place id de l'établissement local présenté dans l'élément
en savoir plus sur l'identifiant dans cet article du centre d'aide - placeType: object | null
_topics mots-clés mentionnés dans les avis clients
contient les mots-clés les plus populaires liés aux produits/services mentionnés dans les avis clients d'une entité commerciale, ainsi que le nombre d'avis mentionnant chaque mot-clé
exemple :
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- popularType: object | null · Response36Afe1097B20_PopularTimes
_times heures de forte affluence
informations relatives aux heures de forte affluence de l'entité commerciale- popularType: object | null
_times _by _days heures de forte affluence
informations sur les heures d'affluence de l'établissement local pour chaque jour de la semaine- propertyType: array (object | null)[] | null
Name horaires d'ouverture le dimanche
- popularType: integer | null
_index indice de popularité indice de popularité relatif et limité dans le temps, mesuré de 0 à 100 ; une valeur plus élevée correspond à une heure de la journée plus fréquentée
- timeType: object | null · Response36Afe1097B20_TimeInfo
heures au format 24 heures
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- positionType: string | null
l'alignement dans le SERP
- priceType: string | null
_level niveau de prix de l'établissement
peut prendre les valeurs :inexpensive,moderate,expensive,very_expensive
s'il n'y a pas d'informations sur le niveau de prix, la valeur seranull - questionsType: integer | null
_and _answers _count Integer numbers.
- rankType: integer | null
_absolute rang absolu parmi tous les éléments
- rankType: integer | null
_group position au sein d'un groupe d'éléments ayant des valeurs
typeidentiques
les positions des éléments ayant des valeurstypedifférentes sont omises derank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- ratingType: object | null
_distribution la répartition des notes de l'entité commerciale
l'objet affiche le nombre de notes de 1 à 5 étoiles, selon les avis des utilisateurs- propertyType: integer | null Format: Int64
Name
- servicesType: array (object | null)[] | null
liste des services proposés par l'établissement
- categoryType: string | null
catégorie d'entreprise
catégorie générale Google My Business qui décrit le mieux les services fournis par l'entité commerciale - priceType: object | null · Response36Afe1097B20_PriceInfo
- currencyType: string | null
devise du prix indiqué code ISO de la devise appliquée au prix
- currentType: number | null Format: double
prix actuel indique le prix actuel du produit ou du service présenté dans le résultat
- displayedType: string | null
_price chaîne de prix dans le résultat chaîne de prix brute telle que fournie dans le résultat
- isType: boolean | null
_price _range le prix est fourni sous forme de fourchette indique si un prix est fourni sous forme de fourchette
- maxType: number | null Format: double
_value le prix maximum le prix maximum du produit ou du service tel qu'indiqué dans le résultat
- regularType: number | null Format: double
prix normal indique le prix normal du produit ou du service sans réduction appliquée
- snippetType: string | null
informations complémentaires sur l'entité commerciale
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés
- snippetType: string | null
informations complémentaires sur l'entité commerciale
- titleType: string | null
titre de l'élément dans le SERP
le nom de l'entité commerciale pour laquelle les résultats sont collectés - totalType: integer | null Format: int64
_photos nombre total d'images présentées dans le profil Google My Business
- typeType: string | null
type d'élément
- urlType: string | null
url absolue de l'entité commerciale
- workType: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time détails des horaires d'ouverture
informations relatives aux horaires d'ouverture de l'entité commerciale- workType: object | null · Response36Afe1097B20_WorkHours
_hours horaires d'ouverture
informations sur les horaires de travail de l'établissement local- currentType: string | null
_status statut actuel de l'établissement
indique si l'établissement est ouvert ou fermé - timetableType: object | null
tableau des horaires d'ouverture
- propertyType: array (object | null)[] | null
Name horaires d'ouverture le dimanche
- closeType: object | null · Response36Afe1097B20_TimeInfo
heure de fermeture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- openType: object | null · Response36Afe1097B20_TimeInfo
heure d'ouverture
- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- itemsType: integer | null Format: int64
_count types d'éléments
le nombre d'éléments du tableauitems - keywordType: string | null
mot-clé reçu dans un tableau POST
le mot-clé est renvoyé avec %## décodé (le caractère '+' sera décodé en espace)
ce champ contiendra le paramètrecidsi vous l'avez spécifié dans le champkeywordlors de la définition d'une tâche ;
exemple :cid:2946633002421908862
en savoir plus sur le paramètre dans cet article du centre d'aide - languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- seType: string | null
_domain domaine du moteur de recherche tel que spécifié dans un tableau POST
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "RustyBrick, Inc."
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"contact_url": null,
"contributor_url": null,
"book_online_url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"questions_and_answers_count": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": "[Max Depth Exceeded]",
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"is_directory_item": null,
"directory": "[Max Depth Exceeded]",
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}