Partager via


Yelp (Éditeur indépendant) (préversion)

Le connecteur Intune vous permet d’obtenir le meilleur contenu local, les points d’intérêt et les avis des utilisateurs de millions d’entreprises dans 32 pays.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Ahmad Najjar
Messagerie électronique ahmadn82@hotmail.com
Métadonnées du connecteur
Éditeur Ahmad Najjar
Site internet https://www.yelp.com/
Politique de confidentialité https://terms.yelp.com/privacy/

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Clé d’API Yelp securestring Fournissez une clé API Yelp en tant que « Porteur API_KEY » Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Autocomplétion

Fournissez des suggestions de saisie semi-automatique pour les entreprises, les mots clés de recherche et les catégories.

Obtenir des avis

Obtenez jusqu’à trois extraits de révision pour une entreprise.

Obtenir les détails de l’entreprise

Obtenez des données professionnelles enrichies, telles que le nom, l’adresse, le numéro de téléphone, les photos, l’évaluation de Yelp, les niveaux de prix et les heures d’opération.

Rechercher des entreprises

Recherchez les entreprises par terme (mot clé), catégorie, emplacement, niveau de prix, etc. Utilisez cette action lorsque vous avez des informations générales sur le nom et l’emplacement biz, mais que vous ne connaissez pas l’adresse.

Rechercher des téléphones professionnels

Retourne une liste d’entreprises en fonction du numéro de téléphone fourni. Utilisez cette action lorsque vous avez uniquement le numéro de téléphone ou moins confiant sur d’autres critères correspondants.

Rechercher une correspondance d’entreprise

Trouvez l’entreprise de Yelp qui correspond à un emplacement d’entrée exact. Utilisez cette action pour faire correspondre les données professionnelles provenant d’autres sources avec les entreprises de Yelp.

Autocomplétion

Fournissez des suggestions de saisie semi-automatique pour les entreprises, les mots clés de recherche et les catégories.

Paramètres

Nom Clé Obligatoire Type Description
Texto
text True string

Texte pour lequel renvoyer des suggestions de saisie semi-automatique.

Latitude
latitude True double

Obligatoire si vous souhaitez obtenir des suggestions de saisie semi-automatique pour les entreprises. Latitude de l’emplacement pour rechercher des suggestions de saisie semi-automatique pour les entreprises.

Longitude
longitude True double

Obligatoire si vous souhaitez obtenir des suggestions de saisie semi-automatique pour les entreprises. Longitude de l’emplacement à rechercher des suggestions de saisie semi-automatique pour l’entreprise.

Paramètres régionaux
locale string

En_US par défaut. (Voir https://bit.ly/3lwvIWU)

Retours

Nom Chemin d’accès Type Description
petits caractères
terms array of object

petits caractères

texte
terms.text string

texte

Entreprises
businesses array of object

Entreprises

nom
businesses.name string

nom

pièce d'identité
businesses.id string

pièce d'identité

texte
businesses.text string

texte

categories
categories array of object

categories

alias
categories.alias string

alias

title
categories.title string

title

Obtenir des avis

Obtenez jusqu’à trois extraits de révision pour une entreprise.

Paramètres

Nom Clé Obligatoire Type Description
ID
id True string

Id unique De Yelp de cette entreprise.

Paramètres régionaux
locale string

En_US par défaut. (Voir https://bit.ly/3lwvIWU)

Retours

Nom Chemin d’accès Type Description
critiques
reviews array of object

critiques

pièce d'identité
reviews.id string

pièce d'identité

notation
reviews.rating integer

notation

pièce d'identité
reviews.user.id string

pièce d'identité

profile_url
reviews.user.profile_url string

profile_url

image_url
reviews.user.image_url string

image_url

nom
reviews.user.name string

nom

texte
reviews.text string

texte

time_created
reviews.time_created string

Heure créée

URL
reviews.url string

URL

total
total integer

total

possible_languages
possible_languages array of string

Langues possibles

Obtenir les détails de l’entreprise

Obtenez des données professionnelles enrichies, telles que le nom, l’adresse, le numéro de téléphone, les photos, l’évaluation de Yelp, les niveaux de prix et les heures d’opération.

Paramètres

Nom Clé Obligatoire Type Description
ID
id True string

Id unique De Yelp de cette entreprise.

Paramètres régionaux
locale string

En_US par défaut. (Voir https://bit.ly/3lwvIWU)

Retours

Nom Chemin d’accès Type Description
pièce d'identité
id string

pièce d'identité

alias
alias string

alias

nom
name string

nom

image_url
image_url string

image_url

is_claimed
is_claimed boolean

is_claimed

is_closed
is_closed boolean

is_closed

URL
url string

URL

phone
phone string

phone

display_phone
display_phone string

display_phone

review_count
review_count integer

review_count

categories
categories array of object

categories

alias
categories.alias string

alias

title
categories.title string

title

notation
rating float

notation

Adresse1
location.address1 string

Adresse1

Adresse2
location.address2 string

Adresse2

address3
location.address3 string

address3

city
location.city string

city

zip_code
location.zip_code string

zip_code

country
location.country string

country

état
location.state string

état

display_address
location.display_address array of string

display_address

cross_streets
location.cross_streets string

cross_streets

latitude
coordinates.latitude float

latitude

longitude
coordinates.longitude float

longitude

photos
photos array of string

photos

price
price string

price

Heures
hours array of object

Heures

ouvrir
hours.open array of object

ouvrir

is_overnight
hours.open.is_overnight boolean

is_overnight

start
hours.open.start string

start

end
hours.open.end string

end

jour
hours.open.day integer

jour

hours_type
hours.hours_type string

hours_type

is_open_now
hours.is_open_now boolean

is_open_now

transactions
transactions array of

transactions

special_hours
special_hours array of object

special_hours

date
special_hours.date string

date

is_closed
special_hours.is_closed string

is_closed

start
special_hours.start string

start

end
special_hours.end string

end

is_overnight
special_hours.is_overnight boolean

is_overnight

Rechercher des entreprises

Recherchez les entreprises par terme (mot clé), catégorie, emplacement, niveau de prix, etc. Utilisez cette action lorsque vous avez des informations générales sur le nom et l’emplacement biz, mais que vous ne connaissez pas l’adresse.

Paramètres

Nom Clé Obligatoire Type Description
Terme (mot clé)
term True string

Terme de recherche, par exemple « restaurants ». Le terme peut également être des noms d’entreprise.

Emplacement
location True string

Zone géographique utilisée lors de la recherche d’entreprises. Par exemple New York, NYC

Latitude
latitude double

Latitude de l’emplacement que vous souhaitez rechercher à proximité.

Longtitude
longtitude double

Longitude de l’emplacement à rechercher à proximité.

Radius
radius integer

Rayon de recherche suggéré en mètres. (Max : 40000 m)

Catégories
categories string

(Voir https://bit.ly/3jnraj5)

Paramètres régionaux
locale string

En_US par défaut. (Voir https://bit.ly/3lwvIWU)

Limit
limit integer

Nombre de résultats métier à retourner. Par défaut (20). Max (50)

Décalage
offset integer

Décaler la liste des résultats métier retournés par ce montant.

Trier par
sort_by string

Suggestion à l’algorithme de recherche selon laquelle les résultats doivent être triés.

Ouvrir maintenant
open_now boolean

(Default=false). Lorsque la valeur est true, retournez uniquement les entreprises ouvertes maintenant.

Retours

Nom Chemin d’accès Type Description
Total
total integer

Nombre total d’entreprises Qu’il trouve en fonction des critères de recherche. Parfois, la valeur peut dépasser 1 000. Dans ce cas, vous pouvez toujours obtenir jusqu’à 1 000 entreprises à l’aide de plusieurs requêtes et combinaisons des paramètres « limite » et « offset ».

Entreprises
businesses array of object

Liste des résultats de l’entreprise Sur la base des critères de recherche.

Notation
businesses.rating float

Évaluation pour cette entreprise (valeur comprise entre 1, 1,5, ... 4.5, 5).

Prix
businesses.price string

Niveau de prix de l’entreprise. La valeur est une valeur de $, $$, $$$ et $$$$$.

Téléphone
businesses.phone string

Numéro de téléphone de l’entreprise.

ID
businesses.id string

Id unique De Yelp de cette entreprise.

Alias
businesses.alias string

Un alias Unique De Yelp de cette entreprise. Peut contenir des caractères Unicode. Exemple : « yelp-san-francisco »

Est fermé
businesses.is_closed boolean

Indique si l’entreprise a été fermée (définitivement)

categories
businesses.categories array of object

Liste des paires de titres et d’alias associées à cette entreprise.

alias
businesses.categories.alias string

Alias d’une catégorie, lors de la recherche d’entreprises dans certaines catégories, utilisez un alias plutôt que le titre.

title
businesses.categories.title string

Titre d’une catégorie à des fins d’affichage.

Nombre de révisions
businesses.review_count integer

Nombre de révisions pour cette entreprise.

Nom
businesses.name string

Nom de cette entreprise.

URL
businesses.url string

URL de la page d’entreprise sur Yelp.

Latitude
businesses.coordinates.latitude float

Latitude de cette entreprise.

Longitude
businesses.coordinates.longitude float

Longitude de cette entreprise.

URL de l’image
businesses.image_url string

URL de la photo pour cette entreprise.

Ville
businesses.location.city string

Ville de cette entreprise

Pays
businesses.location.country string

Code de pays de cette entreprise. (ISO 3166-1 alpha-2)

Adresse 2
businesses.location.address2 string

Adresse de rue de cette entreprise, a continué.

Adresse 3
businesses.location.address3 string

Adresse de rue de cette entreprise, a continué.

État
businesses.location.state string

Code d’état de cette entreprise. ISO 3166-2 (avec quelques exceptions)

Adresse 1
businesses.location.address1 string

Adresse de rue de cette entreprise.

Code postal
businesses.location.zip_code string

Code postal de cette entreprise.

Distance
businesses.distance float

Distance en mètres de l’emplacement de recherche. Cela retourne des compteurs indépendamment des paramètres régionaux.

transactions
businesses.transactions array of string

Liste des transactions à laquelle l’entreprise est inscrite. Les valeurs prises en charge actuelles sont l’enlèvement, la livraison et la restaurant_reservation.

Latitude
region.center.latitude double

Position de latitude du centre des limites de la carte.

Longitude
region.center.longitude double

Position de longitude du centre des limites de la carte.

Rechercher des téléphones professionnels

Retourne une liste d’entreprises en fonction du numéro de téléphone fourni. Utilisez cette action lorsque vous avez uniquement le numéro de téléphone ou moins confiant sur d’autres critères correspondants.

Paramètres

Nom Clé Obligatoire Type Description
Téléphone
phone True string

Numéro de téléphone de l’entreprise à rechercher. (comme +14159083801)

Paramètres régionaux
locale string

En_US par défaut. (Voir https://bit.ly/3lwvIWU)

Retours

Nom Chemin d’accès Type Description
total
total integer

total

Entreprises
businesses array of object

Entreprises

notation
businesses.rating float

notation

price
businesses.price string

price

phone
businesses.phone string

phone

pièce d'identité
businesses.id string

pièce d'identité

alias
businesses.alias string

alias

categories
businesses.categories array of object

categories

alias
businesses.categories.alias string

alias

title
businesses.categories.title string

title

review_count
businesses.review_count integer

review_count

nom
businesses.name string

nom

URL
businesses.url string

URL

latitude
businesses.coordinates.latitude float

latitude

longitude
businesses.coordinates.longitude float

longitude

image_url
businesses.image_url string

image_url

is_closed
businesses.is_closed boolean

is_closed

city
businesses.location.city string

city

country
businesses.location.country string

country

Adresse2
businesses.location.address2 string

Adresse2

address3
businesses.location.address3 string

address3

état
businesses.location.state string

état

Adresse1
businesses.location.address1 string

Adresse1

zip_code
businesses.location.zip_code string

zip_code

transactions
businesses.transactions array of string

transactions

Rechercher une correspondance d’entreprise

Trouvez l’entreprise de Yelp qui correspond à un emplacement d’entrée exact. Utilisez cette action pour faire correspondre les données professionnelles provenant d’autres sources avec les entreprises de Yelp.

Paramètres

Nom Clé Obligatoire Type Description
Nom
name True string

Nom de l’entreprise. La longueur maximale est de 64 ; seuls les chiffres, les lettres, les espaces et !#$%&+, ./ :?@' sont autorisés.

Adresse 1
address1 True string

Première ligne de l’adresse de l’entreprise. La longueur maximale est de 64 ; seuls les chiffres, les lettres, les espaces et /#& ;, sont autorisés. La chaîne vide « » est autorisée ; cela correspondra spécifiquement à certaines entreprises de service qui n’ont pas d’adresse postale.

Adresse 2
address2 string

Deuxième ligne de l’adresse de l’entreprise. La longueur maximale est de 64 ; seuls les chiffres, les lettres, les espaces et /#& ;, sont autorisés.

Adresse 3
address3 string

Troisième ligne de l’adresse de l’entreprise. La longueur maximale est de 64 ; seuls les chiffres, les lettres, les espaces et /#& ;, sont autorisés.

Ville
city True string

La ville de l’entreprise. La longueur maximale est de 64 ; chiffres, lettres, espaces et . () sont autorisés.

État
state True string

Code d’état ISO 3166-2 (avec quelques exceptions) de cette entreprise. La longueur maximale est 3.

Pays
country True string

Code pays ISO 3166-1 alpha-2 de cette entreprise. La longueur maximale est de 2.

Latitude
latitude double

Latitude WGS84 de l’entreprise en décimales. Doit être compris entre -90 et +90.

Longitude
longitude double

Longitude WGS84 de l’entreprise en degrés décimaux. Doit être compris entre -180 et +180.

Téléphone
phone string

Numéro de téléphone de l’entreprise qui peut être envoyé en tant que (a) mis en forme localement avec des chiffres uniquement (par exemple, 016703080) ou (b) au format international avec un signe + de début et des chiffres uniquement après (+35316703080). La longueur maximale est de 32.

Code postal
zip_code string

Code postal de cette entreprise.

ID d’entreprise de Yelp
yelp_business_id string

Identificateur unique de l’entreprise s’il est disponible. Utilisé comme indicateur lors de la recherche d’une entreprise correspondante.

Limit
limit integer

Nombre maximal de résultats métier à retourner. Par défaut, elle retourne 3. La valeur minimale est 1, la valeur maximale est de 10.

Seuil de correspondance
match_threshold integer

Spécifie si un seuil de qualité de correspondance doit être appliqué aux entreprises correspondantes. Doit être l’un des valeurs « none », « default » ou « strict ». aucun : n’appliquez aucun seuil de qualité de correspondance ; toutes les correspondances commerciales potentielles seront retournées. valeur par défaut : appliquez un seuil de qualité de correspondance de sorte que seules les entreprises qui correspondent très étroitement seront retournées. strict : appliquez un seuil de qualité de correspondance très strict.

Retours

Nom Chemin d’accès Type Description
array of object
nom
name string

nom

Adresse1
location.address1 string

Adresse1

Adresse2
location.address2 string

Adresse2

address3
location.address3 string

address3

city
location.city string

city

état
location.state string

état

zip_code
location.zip_code string

zip_code

country
location.country string

country

latitude
coordinates.latitude float

latitude

longitude
coordinates.longitude float

longitude

phone
phone string

phone

pièce d'identité
id string

pièce d'identité

alias
alias string

alias