Yelp (независимый издатель) (предварительная версия)
Соединитель Yelp позволяет получить лучшее локальное содержимое, точки интереса и отзывы пользователей от миллионов предприятий в 32 странах.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Ахмад Наджяр |
| Адрес электронной почты | ahmadn82@hotmail.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Ахмад Наджяр |
| Веб-сайт | https://www.yelp.com/ |
| Политика конфиденциальности | https://terms.yelp.com/privacy/ |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API Yelp | securestring | Укажите ключ API Yelp в качестве носителя API_KEY | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Автозаполнение |
Предоставьте предложения автозаполнения для предприятий, ключевых слов поиска и категорий. |
| Поиск бизнес-совпадения |
Найдите бизнес Yelp, соответствующий точному расположению ввода. Используйте это действие для сопоставления бизнес-данных из других источников с предприятиями Yelp. |
| Поиск бизнес-телефонов |
Возвращает список предприятий на основе предоставленного номера телефона. Используйте это действие, если у вас есть только номер телефона или менее уверен в других критериях соответствия. |
| Поиск предприятий |
Поиск предприятий по термину (ключевое слово), категория, расположение, уровень цены и т. д. Используйте это действие, если у вас есть общие сведения о biz, например имя и расположение, но не знаете адрес. |
| Получение бизнес-сведений |
Получение богатых бизнес-данных, таких как имя, адрес, номер телефона, фотографии, рейтинг Yelp, уровни цен и часы работы. |
| Получение отзывов |
До трех отзывов для бизнеса. |
Автозаполнение
Предоставьте предложения автозаполнения для предприятий, ключевых слов поиска и категорий.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Текст
|
text | True | string |
Текст для возврата предложений автозавершения. |
|
Широта
|
latitude | True | double |
Требуется, если требуется получить предложения автозаполнения для предприятий. Широта расположения для поиска предложений автозаполнения бизнеса. |
|
Долгота
|
longitude | True | double |
Требуется, если требуется получить предложения автозаполнения для предприятий. Долгота расположения для поиска предложений автозавершения для бизнеса. |
|
Региональные настройки
|
locale | string |
По умолчанию en_US. (См. )https://bit.ly/3lwvIWU |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Условия
|
terms | array of object |
Условия |
|
текст
|
terms.text | string |
текст |
|
Предприятий
|
businesses | array of object |
Предприятий |
|
имя
|
businesses.name | string |
имя |
|
id
|
businesses.id | string |
id |
|
текст
|
businesses.text | string |
текст |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |
Поиск бизнес-совпадения
Найдите бизнес Yelp, соответствующий точному расположению ввода. Используйте это действие для сопоставления бизнес-данных из других источников с предприятиями Yelp.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя
|
name | True | string |
Имя бизнеса. Максимальная длина составляет 64; Разрешены только цифры, буквы, пробелы и !#$%&+, ./:?@. |
|
Адрес 1
|
address1 | True | string |
Первая строка адреса бизнеса. Максимальная длина составляет 64; разрешены только цифры, буквы, пробелы и /#&;. Допускается пустая строка"; это будет специально соответствовать определенным предприятиям услуг, у которых нет уличных адресов. |
|
Адрес 2
|
address2 | string |
Вторая строка адреса бизнеса. Максимальная длина составляет 64; разрешены только цифры, буквы, пробелы и /#&;. |
|
|
Адрес 3
|
address3 | string |
Третья строка адреса бизнеса. Максимальная длина составляет 64; разрешены только цифры, буквы, пробелы и /#&;. |
|
|
Город
|
city | True | string |
Город бизнеса. Максимальная длина составляет 64; только цифры, буквы, пробелы и. () разрешено. |
|
Государство
|
state | True | string |
Код состояния ISO 3166-2 (с несколькими исключениями) этого бизнеса. Максимальная длина составляет 3. |
|
Страна
|
country | True | string |
Код страны ISO 3166-1 alpha-2 для этого бизнеса. Максимальная длина — 2. |
|
Широта
|
latitude | double |
Широта РГS84 бизнеса в десятичных градусах. Должно быть от -90 до +90. |
|
|
Долгота
|
longitude | double |
Долготу компании в десятичных градусах в формате WGS84. Должно быть от -180 до +180. |
|
|
Телефон
|
phone | string |
Номер телефона компании, который можно отправить как (a) локально отформатированный только цифрами (например, 016703080) или (b) на международном уровне, отформатированный с помощью знака и цифр только после (+35316703080). Максимальная длина составляет 32. |
|
|
Почтовый индекс
|
zip_code | string |
Почтовый индекс этого бизнеса. |
|
|
Идентификатор бизнеса Yelp
|
yelp_business_id | string |
Уникальный идентификатор Yelp для бизнеса, если он доступен. Используется в качестве указания при поиске соответствующего бизнеса. |
|
|
Лимит
|
limit | integer |
Максимальное количество возвращаемых бизнес-результатов. По умолчанию возвращается 3. Минимальное значение — 1, максимальное — 10. |
|
|
Пороговое значение соответствия
|
match_threshold | integer |
Указывает, следует ли применять порог качества соответствия к соответствующим предприятиям. Должен быть одним из "нет", "по умолчанию" или "строгим". нет: не применяйте порог качества соответствия; Будут возвращены все потенциальные бизнес-совпадения. значение по умолчанию: применение порога качества соответствия, которое будет возвращено только очень тесно соответствующим предприятиям. strict: применение очень строгого порога качества соответствия. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
имя
|
name | string |
имя |
|
адрес1
|
location.address1 | string |
адрес1 |
|
Адрес2
|
location.address2 | string |
Адрес2 |
|
адрес3
|
location.address3 | string |
адрес3 |
|
city
|
location.city | string |
city |
|
государство
|
location.state | string |
государство |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
широта
|
coordinates.latitude | float |
широта |
|
долгота
|
coordinates.longitude | float |
долгота |
|
phone
|
phone | string |
phone |
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
Поиск бизнес-телефонов
Возвращает список предприятий на основе предоставленного номера телефона. Используйте это действие, если у вас есть только номер телефона или менее уверен в других критериях соответствия.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Телефон
|
phone | True | string |
Номер телефона для бизнеса, для которого требуется выполнить поиск. (например, +14159083801) |
|
Региональные настройки
|
locale | string |
По умолчанию en_US. (См. )https://bit.ly/3lwvIWU |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
итог
|
total | integer |
итог |
|
Предприятий
|
businesses | array of object |
Предприятий |
|
рейтинг
|
businesses.rating | float |
рейтинг |
|
цена
|
businesses.price | string |
цена |
|
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 |
|
имя
|
businesses.name | string |
имя |
|
URL-адрес
|
businesses.url | string |
URL-адрес |
|
широта
|
businesses.coordinates.latitude | float |
широта |
|
долгота
|
businesses.coordinates.longitude | float |
долгота |
|
ссылка_на_изображение
|
businesses.image_url | string |
ссылка_на_изображение |
|
is_closed
|
businesses.is_closed | boolean |
is_closed |
|
city
|
businesses.location.city | string |
city |
|
country
|
businesses.location.country | string |
country |
|
Адрес2
|
businesses.location.address2 | string |
Адрес2 |
|
адрес3
|
businesses.location.address3 | string |
адрес3 |
|
государство
|
businesses.location.state | string |
государство |
|
адрес1
|
businesses.location.address1 | string |
адрес1 |
|
zip_code
|
businesses.location.zip_code | string |
zip_code |
|
транзакции;
|
businesses.transactions | array of string |
транзакции; |
Поиск предприятий
Поиск предприятий по термину (ключевое слово), категория, расположение, уровень цены и т. д. Используйте это действие, если у вас есть общие сведения о biz, например имя и расположение, но не знаете адрес.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Термин (ключевое слово)
|
term | True | string |
Термин поиска, например "рестораны". Термин также может быть бизнес-именами. |
|
Местоположение
|
location | True | string |
Географическая область, используемая при поиске предприятий. Например, Нью-Йорк, Нью-Йорк |
|
Широта
|
latitude | double |
Широта расположения, которое нужно найти поблизости. |
|
|
Longtitude
|
longtitude | double |
Долгота расположения, которое требуется выполнить поиск поблизости. |
|
|
Радиус.
|
radius | integer |
Предлагаемый радиус поиска в метрах. (Макс: 40000 м) |
|
|
Категории
|
categories | string |
(См. )https://bit.ly/3jnraj5 |
|
|
Региональные настройки
|
locale | string |
По умолчанию en_US. (См. )https://bit.ly/3lwvIWU |
|
|
Лимит
|
limit | integer |
Количество возвращаемых бизнес-результатов. Значение по умолчанию (20). Максимальное (50) |
|
|
Смещение
|
offset | integer |
Смещение списка возвращаемых бизнес-результатов на этот объем. |
|
|
Сортировать по
|
sort_by | string |
Предложение алгоритму поиска, по которому будут отсортированы результаты. |
|
|
Открыть сейчас
|
open_now | boolean |
(Default=false). Если задано значение true, возвращаются только предприятия, открытые сейчас. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Total
|
total | integer |
Общее количество поисков бизнес-Yelp на основе критериев поиска. Иногда значение может превышать 1000. В таком случае вы по-прежнему можете получить до 1000 предприятий, используя несколько запросов и сочетаний параметров "предел" и "смещение". |
|
Предприятий
|
businesses | array of object |
Список бизнес-Yelp находит на основе критериев поиска. |
|
Rating
|
businesses.rating | float |
Рейтинг для этого бизнеса (диапазоны значений от 1, 1,5, ... 4.5, 5). |
|
Цена
|
businesses.price | string |
Ценовой уровень бизнеса. Значение является одним из $, $$, $$ и $}. |
|
Телефон
|
businesses.phone | string |
Номер телефона для бизнеса. |
|
Идентификатор
|
businesses.id | string |
Уникальный идентификатор Yelp этого бизнеса. |
|
Псевдоним
|
businesses.alias | string |
Уникальный псевдоним Yelp для этого бизнеса. Может содержать символы юникода. Пример: "yelp-san-francisco" |
|
Закрыто
|
businesses.is_closed | boolean |
Независимо от того, был ли бизнес (окончательно закрытым) |
|
categories
|
businesses.categories | array of object |
Список пар названий категорий и псевдонимов, связанных с этим бизнесом. |
|
alias
|
businesses.categories.alias | string |
Псевдоним категории, при поиске бизнеса в определенных категориях, используйте псевдоним, а не название. |
|
title
|
businesses.categories.title | string |
Название категории для отображения. |
|
Количество просмотров
|
businesses.review_count | integer |
Количество отзывов для этого бизнеса. |
|
Имя
|
businesses.name | string |
Имя этого бизнеса. |
|
URL
|
businesses.url | string |
URL-адрес для бизнес-страницы на сайте Yelp. |
|
Широта
|
businesses.coordinates.latitude | float |
Широта этого бизнеса. |
|
Долгота
|
businesses.coordinates.longitude | float |
Долгота этого бизнеса. |
|
URL-адрес изображения
|
businesses.image_url | string |
URL-адрес фотографии для этого бизнеса. |
|
Город
|
businesses.location.city | string |
Город этого бизнеса |
|
Страна
|
businesses.location.country | string |
Код страны этого бизнеса. (ISO 3166-1 alpha-2) |
|
Адрес 2
|
businesses.location.address2 | string |
Адрес улицы этого бизнеса, продолжался. |
|
Адрес 3
|
businesses.location.address3 | string |
Адрес улицы этого бизнеса, продолжался. |
|
Государство
|
businesses.location.state | string |
Код состояния этого бизнеса. ISO 3166-2 (с несколькими исключениями) |
|
Адрес 1
|
businesses.location.address1 | string |
Адрес улицы этого бизнеса. |
|
Почтовый индекс
|
businesses.location.zip_code | string |
Почтовый индекс этого бизнеса. |
|
Расстояние
|
businesses.distance | float |
Расстояние в метрах от расположения поиска. Это возвращает метры независимо от языкового стандарта. |
|
транзакции;
|
businesses.transactions | array of string |
Список транзакций Yelp, зарегистрированных для бизнеса. Текущие поддерживаемые значения: получение, доставка и restaurant_reservation. |
|
Широта
|
region.center.latitude | double |
Позиция широты по центру границ карты. |
|
Долгота
|
region.center.longitude | double |
Позиция долготы в центре границ карты. |
Получение бизнес-сведений
Получение богатых бизнес-данных, таких как имя, адрес, номер телефона, фотографии, рейтинг Yelp, уровни цен и часы работы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор
|
id | True | string |
Уникальный идентификатор Yelp этого бизнеса. |
|
Региональные настройки
|
locale | string |
По умолчанию en_US. (См. )https://bit.ly/3lwvIWU |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
|
имя
|
name | string |
имя |
|
ссылка_на_изображение
|
image_url | string |
ссылка_на_изображение |
|
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 |
|
рейтинг
|
rating | float |
рейтинг |
|
адрес1
|
location.address1 | string |
адрес1 |
|
Адрес2
|
location.address2 | string |
Адрес2 |
|
адрес3
|
location.address3 | string |
адрес3 |
|
city
|
location.city | string |
city |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
государство
|
location.state | string |
государство |
|
display_address
|
location.display_address | array of string |
display_address |
|
cross_streets
|
location.cross_streets | string |
cross_streets |
|
широта
|
coordinates.latitude | float |
широта |
|
долгота
|
coordinates.longitude | float |
долгота |
|
photos
|
photos | array of string |
photos |
|
цена
|
price | string |
цена |
|
Часов
|
hours | array of object |
Часов |
|
открытый
|
hours.open | array of object |
открытый |
|
is_overnight
|
hours.open.is_overnight | boolean |
is_overnight |
|
start
|
hours.open.start | string |
start |
|
конец
|
hours.open.end | string |
конец |
|
day
|
hours.open.day | integer |
day |
|
hours_type
|
hours.hours_type | string |
hours_type |
|
is_open_now
|
hours.is_open_now | boolean |
is_open_now |
|
транзакции;
|
transactions | array of |
транзакции; |
|
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 |
|
конец
|
special_hours.end | string |
конец |
|
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
Получение отзывов
До трех отзывов для бизнеса.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор
|
id | True | string |
Уникальный идентификатор Yelp этого бизнеса. |
|
Региональные настройки
|
locale | string |
По умолчанию en_US. (См. )https://bit.ly/3lwvIWU |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Отзывов
|
reviews | array of object |
Отзывов |
|
id
|
reviews.id | string |
id |
|
рейтинг
|
reviews.rating | integer |
рейтинг |
|
id
|
reviews.user.id | string |
id |
|
profile_url
|
reviews.user.profile_url | string |
profile_url |
|
ссылка_на_изображение
|
reviews.user.image_url | string |
ссылка_на_изображение |
|
имя
|
reviews.user.name | string |
имя |
|
текст
|
reviews.text | string |
текст |
|
time_created
|
reviews.time_created | string |
Время создания |
|
URL-адрес
|
reviews.url | string |
URL-адрес |
|
итог
|
total | integer |
итог |
|
possible_languages
|
possible_languages | array of string |
Возможные языки |