Yelp (Editor Independente) (versão prévia)
O conector do Yelp permite que você obtenha o melhor conteúdo local, pontos de interesse e revisões de usuários de milhões de empresas em 32 países.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Ahmad Najjar |
| ahmadn82@hotmail.com |
| Metadados do conector | |
|---|---|
| Publicador | Ahmad Najjar |
| Site | https://www.yelp.com/ |
| Política de privacidade | https://terms.yelp.com/privacy/ |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Tecla de API do Yelp | secureString | Fornecer uma chave de API do Yelp como 'Portador API_KEY' | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Localizar correspondência comercial |
Localize o negócio do Yelp que corresponde a um local de entrada exato. Use essa ação para corresponder dados comerciais de outras fontes com empresas do Yelp. |
| Obter detalhes de negócios |
Obtenha dados de negócios avançados, como nome, endereço, número de telefone, fotos, classificação do Yelp, níveis de preço e horas de operação. |
| Obter revisões |
Obtenha até três trechos de revisão para uma empresa. |
| Pesquisar empresas |
Pesquise empresas por Termo (palavra-chave), categoria, localização, nível de preço etc. Use essa ação quando você tiver informações gerais sobre o biz, como nome e localização, mas não souber o endereço. |
| Pesquisar Telefones Comerciais |
Retorna uma lista de empresas com base no número de telefone fornecido. Use essa ação quando você tiver apenas o número de telefone ou menos confiante sobre outros critérios correspondentes. |
| Preenchimento automático |
Forneça sugestões de preenchimento automático para empresas, pesquise palavras-chave e categorias. |
Localizar correspondência comercial
Localize o negócio do Yelp que corresponde a um local de entrada exato. Use essa ação para corresponder dados comerciais de outras fontes com empresas do Yelp.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
O nome do negócio. O comprimento máximo é 64; somente dígitos, letras, espaços e !#$%&+, ./:?@'são permitidos. |
|
Endereço 1
|
address1 | True | string |
A primeira linha do endereço da empresa. O comprimento máximo é 64; somente dígitos, letras, espaços e /#&;.: são permitidos. A cadeia de caracteres vazia "" é permitida; isso corresponderá especificamente a determinadas empresas de serviço que não têm endereço de rua. |
|
Endereço 2
|
address2 | string |
A segunda linha do endereço da empresa. O comprimento máximo é 64; somente dígitos, letras, espaços e /#&;.: são permitidos. |
|
|
Endereço 3
|
address3 | string |
A terceira linha do endereço da empresa. O comprimento máximo é 64; somente dígitos, letras, espaços e /#&;.: são permitidos. |
|
|
City
|
city | True | string |
A cidade do negócio. O comprimento máximo é 64; apenas dígitos, letras, espaços e . () são permitidos. |
|
Estado
|
state | True | string |
O código de estado ISO 3166-2 (com algumas exceções) dessa empresa. O comprimento máximo é 3. |
|
País
|
country | True | string |
O código de país alfa-2 iso 3166-1 deste negócio. O comprimento máximo é 2. |
|
Latitude
|
latitude | double |
A latitude WGS84 do negócio em graus decimais. Deve estar entre -90 e +90. |
|
|
Longitude
|
longitude | double |
A longitude WGS84 do negócio em graus decimais. Deve estar entre -180 e +180. |
|
|
Telefone
|
phone | string |
O número de telefone da empresa que pode ser enviado como (a) formatado localmente apenas com dígitos (por exemplo, 016703080) ou (b) formatado internacionalmente com um sinal + à esquerda e dígitos somente após (+35316703080). O comprimento máximo é 32. |
|
|
Código Postal
|
zip_code | string |
O cep deste negócio. |
|
|
ID de negócios do Yelp
|
yelp_business_id | string |
Identificador exclusivo do Yelp da empresa, se disponível. Usado como uma dica ao encontrar um negócio correspondente. |
|
|
Limit
|
limit | integer |
Número máximo de resultados de negócios a serem retornados. Por padrão, ele retornará 3. O mínimo é 1, o máximo é 10. |
|
|
Limite de correspondência
|
match_threshold | integer |
Especifica se um limite de qualidade de correspondência deve ser aplicado às empresas correspondentes. Deve ser um "nenhum", "padrão" ou "estrito". nenhum: não aplique nenhum limite de qualidade de correspondência; todas as possíveis correspondências comerciais serão retornadas. padrão: aplique um limite de qualidade de correspondência de modo que somente empresas muito próximas sejam retornadas. estrito: aplique um limite de qualidade de correspondência muito estrito. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
nome
|
name | string |
nome |
|
endereço1
|
___location.address1 | string |
endereço1 |
|
endereço2
|
___location.address2 | string |
endereço2 |
|
address3
|
___location.address3 | string |
address3 |
|
city
|
___location.city | string |
city |
|
estado
|
___location.state | string |
estado |
|
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 |
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
Obter detalhes de negócios
Obtenha dados de negócios avançados, como nome, endereço, número de telefone, fotos, classificação do Yelp, níveis de preço e horas de operação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID exclusiva do Yelp deste negócio. |
|
Local
|
locale | string |
En_US padrão. (Consulte https://bit.ly/3lwvIWU) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
|
nome
|
name | string |
nome |
|
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 |
|
classificação
|
rating | float |
classificação |
|
endereço1
|
___location.address1 | string |
endereço1 |
|
endereço2
|
___location.address2 | string |
endereço2 |
|
address3
|
___location.address3 | string |
address3 |
|
city
|
___location.city | string |
city |
|
zip_code
|
___location.zip_code | string |
zip_code |
|
country
|
___location.country | string |
country |
|
estado
|
___location.state | string |
estado |
|
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 |
|
horas
|
hours | array of object |
horas |
|
em aberto
|
hours.open | array of object |
em aberto |
|
is_overnight
|
hours.open.is_overnight | boolean |
is_overnight |
|
start
|
hours.open.start | string |
start |
|
término
|
hours.open.end | string |
término |
|
dia
|
hours.open.day | integer |
dia |
|
hours_type
|
hours.hours_type | string |
hours_type |
|
is_open_now
|
hours.is_open_now | boolean |
is_open_now |
|
transações
|
transactions | array of |
transações |
|
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 |
|
término
|
special_hours.end | string |
término |
|
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
Obter revisões
Obtenha até três trechos de revisão para uma empresa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID exclusiva do Yelp deste negócio. |
|
Local
|
locale | string |
En_US padrão. (Consulte https://bit.ly/3lwvIWU) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
avaliações
|
reviews | array of object |
avaliações |
|
id
|
reviews.id | string |
id |
|
classificação
|
reviews.rating | integer |
classificação |
|
id
|
reviews.user.id | string |
id |
|
profile_url
|
reviews.user.profile_url | string |
profile_url |
|
image_url
|
reviews.user.image_url | string |
image_url |
|
nome
|
reviews.user.name | string |
nome |
|
enviar SMS
|
reviews.text | string |
enviar SMS |
|
time_created
|
reviews.time_created | string |
Tempo criado |
|
url
|
reviews.url | string |
url |
|
total
|
total | integer |
total |
|
possible_languages
|
possible_languages | array of string |
Idiomas possíveis |
Pesquisar empresas
Pesquise empresas por Termo (palavra-chave), categoria, localização, nível de preço etc. Use essa ação quando você tiver informações gerais sobre o biz, como nome e localização, mas não souber o endereço.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Termo (palavra-chave)
|
term | True | string |
Termo de pesquisa, por exemplo, "restaurantes". O termo também pode ser nomes de negócios. |
|
Localização
|
___location | True | string |
A área geográfica usada ao pesquisar negócios. Por exemplo, Nova York, NYC |
|
Latitude
|
latitude | double |
Latitude do local que você deseja pesquisar nas proximidades. |
|
|
Longtitude
|
longtitude | double |
Longitude do local que você deseja pesquisar nas proximidades. |
|
|
Raio
|
radius | integer |
Um raio de pesquisa sugerido em metros. (Máximo: 40000 m) |
|
|
Categorias
|
categories | string |
(Consulte https://bit.ly/3jnraj5) |
|
|
Local
|
locale | string |
En_US padrão. (Consulte https://bit.ly/3lwvIWU) |
|
|
Limit
|
limit | integer |
Número de resultados de negócios a serem retornados. Padrão (20). Máximo (50) |
|
|
Offset
|
offset | integer |
Desempenque a lista de resultados comerciais retornados por esse valor. |
|
|
Classificar por
|
sort_by | string |
Sugestão para o algoritmo de pesquisa pelo qual os resultados serão classificados. |
|
|
Abrir Agora
|
open_now | boolean |
(Default=false). Quando definido como true, retorne apenas os negócios abertos agora. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Total
|
total | integer |
Número total de localizações do Yelp de negócios com base nos critérios de pesquisa. Às vezes, o valor pode exceder 1000. Nesse caso, você ainda pode obter apenas até 1.000 empresas usando várias consultas e combinações dos parâmetros "limite" e "deslocamento". |
|
Empresas
|
businesses | array of object |
Lista de localizações de negócios do Yelp com base nos critérios de pesquisa. |
|
Rating
|
businesses.rating | float |
Classificação para este negócio (o valor varia de 1, 1,5, ... 4.5, 5). |
|
Preço
|
businesses.price | string |
Nível de preço do negócio. O valor é de $, $$, $$$ e $$$$. |
|
Telefone
|
businesses.phone | string |
Número de telefone da empresa. |
|
ID
|
businesses.id | string |
ID exclusiva do Yelp deste negócio. |
|
Alias
|
businesses.alias | string |
Alias exclusivo do Yelp deste negócio. Pode conter caracteres unicode. Exemplo: "yelp-san-francisco" |
|
Está Fechado
|
businesses.is_closed | boolean |
Se os negócios foram (permanentemente) fechados |
|
categories
|
businesses.categories | array of object |
Lista de pares de título e alias de categoria associados a este negócio. |
|
alias
|
businesses.categories.alias | string |
O alias de uma categoria, ao pesquisar negócios em determinadas categorias, usa alias em vez do título. |
|
title
|
businesses.categories.title | string |
Título de uma categoria para fins de exibição. |
|
Contagem de Revisão
|
businesses.review_count | integer |
Número de revisões para este negócio. |
|
Nome
|
businesses.name | string |
Nome deste negócio. |
|
URL
|
businesses.url | string |
Página URL para empresas no Yelp. |
|
Latitude
|
businesses.coordinates.latitude | float |
Latitude deste negócio. |
|
Longitude
|
businesses.coordinates.longitude | float |
Longitude deste negócio. |
|
URL da imagem
|
businesses.image_url | string |
URL de foto para este negócio. |
|
City
|
businesses.___location.city | string |
Cidade deste negócio |
|
País
|
businesses.___location.country | string |
Código do país deste negócio. (ISO 3166-1 alfa-2) |
|
Endereço 2
|
businesses.___location.address2 | string |
Endereço de rua deste negócio, continuou. |
|
Endereço 3
|
businesses.___location.address3 | string |
Endereço de rua deste negócio, continuou. |
|
Estado
|
businesses.___location.state | string |
Código de estado deste negócio. ISO 3166-2 (com algumas exceções) |
|
Endereço 1
|
businesses.___location.address1 | string |
Endereço de rua deste negócio. |
|
Código Postal
|
businesses.___location.zip_code | string |
Cep deste negócio. |
|
Distância
|
businesses.distance | float |
Distância em metros do local de pesquisa. Isso retorna medidores independentemente da localidade. |
|
transações
|
businesses.transactions | array of string |
Lista de transações do Yelp para as quais a empresa está registrada. Os valores atuais compatíveis são retirada, entrega e restaurant_reservation. |
|
Latitude
|
region.center.latitude | double |
Posição de latitude do centro de limites do mapa. |
|
Longitude
|
region.center.longitude | double |
Posição de longitude do centro de limites do mapa. |
Pesquisar Telefones Comerciais
Retorna uma lista de empresas com base no número de telefone fornecido. Use essa ação quando você tiver apenas o número de telefone ou menos confiante sobre outros critérios correspondentes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Telefone
|
phone | True | string |
Número de telefone da empresa que você deseja pesquisar. (como +14159083801) |
|
Local
|
locale | string |
En_US padrão. (Consulte https://bit.ly/3lwvIWU) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
total
|
total | integer |
total |
|
Empresas
|
businesses | array of object |
Empresas |
|
classificação
|
businesses.rating | float |
classificação |
|
price
|
businesses.price | string |
price |
|
phone
|
businesses.phone | string |
phone |
|
id
|
businesses.id | string |
id |
|
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 |
|
nome
|
businesses.name | string |
nome |
|
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 |
|
endereço2
|
businesses.___location.address2 | string |
endereço2 |
|
address3
|
businesses.___location.address3 | string |
address3 |
|
estado
|
businesses.___location.state | string |
estado |
|
endereço1
|
businesses.___location.address1 | string |
endereço1 |
|
zip_code
|
businesses.___location.zip_code | string |
zip_code |
|
transações
|
businesses.transactions | array of string |
transações |
Preenchimento automático
Forneça sugestões de preenchimento automático para empresas, pesquise palavras-chave e categorias.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto
|
text | True | string |
Texto para o qual retornar sugestões de preenchimento automático. |
|
Latitude
|
latitude | True | double |
Obrigatório se quiser obter sugestões de preenchimento automático para empresas. Latitude do local para procurar sugestões de preenchimento automático de negócios. |
|
Longitude
|
longitude | True | double |
Obrigatório se quiser obter sugestões de preenchimento automático para empresas. Longitude do local para procurar sugestões de preenchimento automático de negócios. |
|
Local
|
locale | string |
En_US padrão. (Consulte https://bit.ly/3lwvIWU) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
termos
|
terms | array of object |
termos |
|
enviar SMS
|
terms.text | string |
enviar SMS |
|
Empresas
|
businesses | array of object |
Empresas |
|
nome
|
businesses.name | string |
nome |
|
id
|
businesses.id | string |
id |
|
enviar SMS
|
businesses.text | string |
enviar SMS |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |