共用方式為

Yelp （獨立發行商） （預覽版）

Yelp 連接器可讓您從 32 個國家/地區的數百萬家企業獲得最好的本地內容、興趣點和用戶評論。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 艾哈邁德·納賈爾
Email ahmadn82@hotmail.com
連接器中繼資料
Publisher 艾哈邁德·納賈爾
網站 https://www.yelp.com/
隱私策略 https://terms.yelp.com/privacy/

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Yelp API 金鑰 securestring 提供 Yelp API 金鑰作為「持有人API_KEY」 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

尋找商業匹配

查找與確切輸入位置匹配的 Yelp 業務。 使用此動作可將其他來源的業務資料與 Yelp 業務進行比對。
搜尋企業

按術語（關鍵字）、類別、位置、價格水平等搜索企業。當您有有關該業務的一般信息（例如名稱和位置）但不知道地址時，請使用此操作。
搜尋商務電話

根據提供的電話號碼傳回企業清單。 當您只有電話號碼或對其他比對條件不太有信心時，請使用此動作。
獲取業務詳情

獲取豐富的業務數據，例如姓名、地址、電話號碼、照片、Yelp 評級、價格水平和營業時間。
獲取評論

獲取最多三個企業的評論摘錄。
自動完成

為企業、搜索關鍵字和類別提供自動完成建議。

尋找商業匹配

作業識別碼：
BusinessMatch

查找與確切輸入位置匹配的 Yelp 業務。 使用此動作可將其他來源的業務資料與 Yelp 業務進行比對。

參數

名稱 機碼 必要 類型 Description
名稱
 name True string

企業名稱。 最大長度為 64;只允許使用數字、字母、空格和 ！#$%&+、./：？@'。
位址 1
 address1 True string

第一行的業務地址。 最大長度為 64;只允許使用數字、字母、空格和 /#&，.： 。 允許使用空字串 “”;這將專門匹配某些沒有街道地址的服務企業。
位址 2
 address2 string

第二行的業務地址。 最大長度為 64;只允許使用數字、字母、空格和 /#&，.： 。
地址 3
 address3 string

第三行業務地址。 最大長度為 64;只允許使用數字、字母、空格和 /#&，.： 。
城市
 city True string

商業之城。 最大長度為 64;只有數字、字母、空格和 .（） 是允許的。
State
 state True string

ISO 3166-2（少數例外）規定了該業務的代碼。 長度上限為 3。
國家
 country True string

該企業的 ISO 3166-1 alpha-2 國家代碼。 長度上限為 2。
緯度
 latitude double

企業的 WGS84 緯度（以十進制度為單位）。 必須介於 -90 和 +90 之間。
經度
 longitude double

企業的WGS84經度（以十進制度為單位）。 必須介於 -180 和 +180 之間。
電話
 phone string

企業的電話號碼可以提交為 （a） 僅以數字本地格式（例如016703080）或 （b） 國際格式，僅以前導 + 號和數字（+35316703080）後面的數字提交。 長度上限為 32。
郵遞區號
 zip_code string

該企業的郵政編碼。
Yelp 企業 ID
 yelp_business_id string

企業的唯一 Yelp 識別碼（如果有）。 用作尋找匹配業務時的提示。
限制
 limit integer

要傳回的業務結果數目上限。 預設情況下，它會傳回 3。 最小值為 1，最大值為 10。
匹配閾值
 match_threshold integer

指定是否應將比對品質臨界值套用至相符的企業。 必須是 'none'、'default' 或 'strict' 之一。 none：不套用任何比對品質臨界值;所有潛在的商業匹配都將被退回。 default：套用比對品質臨界值，以便只傳回非常相符的商家。 strict：套用非常嚴格的比對品質臨界值。

傳回

名稱 路徑 類型 Description
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
緯度 (latitude)
 coordinates.latitude float

緯度 (latitude)
經度 (longitude)
 coordinates.longitude float

經度 (longitude)
phone
 phone string

phone
識別碼
 id string

識別碼
別名
 alias string

別名

搜尋企業

作業識別碼：
BusinessSearch

按術語（關鍵字）、類別、位置、價格水平等搜索企業。當您有有關該業務的一般信息（例如名稱和位置）但不知道地址時，請使用此操作。

參數

名稱 機碼 必要 類型 Description
術語 （關鍵字）
 term True string

搜尋字詞，例如「餐廳」。 該術語也可以是企業名稱。
地點
 location True string

搜尋商家時使用的地理區域。 例如紐約、紐約市
緯度
 latitude double

您要在附近搜尋的位置的緯度。
朗蒂特
 longtitude double

您要在附近搜尋的位置的經度。
Radius
 radius integer

建議的搜尋半徑（以公尺為單位）。 （最大：40000 米）
類別
 categories string

（參見 https://bit.ly/3jnraj5）
Locale
 locale string

預設en_US。 （參見 https://bit.ly/3lwvIWU）
限制
 limit integer

要傳回的業務結果數目。 預設值 （20）。 最大 （50）
Offset
 offset integer

將傳回的業務結果清單抵消此金額。
排序方式
 sort_by string

對搜尋演算法的建議，以便排序結果。
立即開放
 open_now boolean

（預設值=false）。 當設定為 true 時，只會傳回現在開啟的企業。

傳回

名稱 路徑 類型 Description
總數
 total integer

Yelp 根據搜尋條件找到的企業總數。 有時，該值可能會超過 1000。 在這種情況下，您仍然只能使用多個查詢以及“limit”和“offset”參數的組合來獲取最多 1000 個企業。
企業
 businesses array of object

Yelp 根據搜索條件查找的業務列表。
Rating
 businesses.rating float

該業務的評級（值範圍為 1、1.5、...4.5, 5).
價格
 businesses.price string

企業的價格水平。 值是 $、$$、$$$ 和 $$$$ 之一。
電話
 businesses.phone string

企業的電話號碼。
ID
 businesses.id string

該企業的唯一 Yelp ID。
Alias
 businesses.alias string

該業務的唯一 Yelp 別名。 可以包含 Unicode 字元。 範例：「yelp-san-francisco」
已關閉
 businesses.is_closed boolean

業務是否已（永久）關閉
categories
 businesses.categories array of object

與此業務相關的類別標題和別名對的列表。
別名
 businesses.categories.alias string

類別的別名，在搜尋特定類別中的企業時，請使用別名而不是標題。
title
 businesses.categories.title string

用於顯示目的的類別標題。
評論計數
 businesses.review_count integer

該業務的評論數量。
名稱
 businesses.name string

該企業的名稱。
URL
 businesses.url string

Yelp 上商業頁面的 URL。
緯度
 businesses.coordinates.latitude float

這項業務的緯度。
經度
 businesses.coordinates.longitude float

該業務的經度。
圖像網址
 businesses.image_url string

該企業的照片 URL。
城市
 businesses.location.city string

該業務的城市
國家
 businesses.location.country string

該企業的國家/地區代碼。 （ISO 3166-1 阿爾法-2）
位址 2
 businesses.location.address2 string

該企業的街道地址，繼續。
地址 3
 businesses.location.address3 string

該企業的街道地址，繼續。
State
 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

地圖邊界中心的經度位置。

搜尋商務電話

作業識別碼：
PhoneSearch

根據提供的電話號碼傳回企業清單。 當您只有電話號碼或對其他比對條件不太有信心時，請使用此動作。

參數

名稱 機碼 必要 類型 Description
電話
 phone True string

您要搜尋的商家的電話號碼。 （喜歡 +14159083801）
Locale
 locale string

預設en_US。 （參見 https://bit.ly/3lwvIWU）

傳回

名稱 路徑 類型 Description
總計
 total integer

總計
企業
 businesses array of object

企業
評等
 businesses.rating float

評等
價格
 businesses.price string

價格
phone
 businesses.phone string

phone
識別碼
 businesses.id string

識別碼
別名
 businesses.alias string

別名
categories
 businesses.categories array of object

categories
別名
 businesses.categories.alias string

別名
title
 businesses.categories.title string

title
review_count
 businesses.review_count integer

review_count
名稱
 businesses.name string

名稱
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
位址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

交易

獲取業務詳情

作業識別碼：
BusinessDetails

獲取豐富的業務數據，例如姓名、地址、電話號碼、照片、Yelp 評級、價格水平和營業時間。

參數

名稱 機碼 必要 類型 Description
ID
 id True string

該企業的唯一 Yelp ID。
Locale
 locale string

預設en_US。 （參見 https://bit.ly/3lwvIWU）

傳回

名稱 路徑 類型 Description
識別碼
 id string

識別碼
別名
 alias string

別名
名稱
 name string

名稱
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
別名
 categories.alias string

別名
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
緯度 (latitude)
 coordinates.latitude float

緯度 (latitude)
經度 (longitude)
 coordinates.longitude float

經度 (longitude)
相片
 photos array of string

相片
價格
 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

結束
天
 hours.open.day integer

天
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

獲取評論

作業識別碼：
Reviews

獲取最多三個企業的評論摘錄。

參數

名稱 機碼 必要 類型 Description
ID
 id True string

該企業的唯一 Yelp ID。
Locale
 locale string

預設en_US。 （參見 https://bit.ly/3lwvIWU）

傳回

名稱 路徑 類型 Description
審查
 reviews array of object

審查
識別碼
 reviews.id string

識別碼
評等
 reviews.rating integer

評等
識別碼
 reviews.user.id string

識別碼
profile_url
 reviews.user.profile_url string

profile_url
image_url
 reviews.user.image_url string

image_url
名稱
 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

可能的語言

自動完成

作業識別碼：
Autocomplete

為企業、搜索關鍵字和類別提供自動完成建議。

參數

名稱 機碼 必要 類型 Description
文字
 text True string

要傳回自動完成建議的文字。
緯度
 latitude True double

如果想要獲得企業的自動完成建議，則需要。 尋找商務自動完成建議的位置緯度。
經度
 longitude True double

如果想要獲得企業的自動完成建議，則需要。 尋找商務自動完成建議的位置經度。
Locale
 locale string

預設en_US。 （參見 https://bit.ly/3lwvIWU）

傳回

名稱 路徑 類型 Description
條款
 terms array of object

條款
收發簡訊
 terms.text string

收發簡訊
企業
 businesses array of object

企業
名稱
 businesses.name string

名稱
識別碼
 businesses.id string

識別碼
收發簡訊
 businesses.text string

收發簡訊
categories
 categories array of object

categories
別名
 categories.alias string

別名
title
 categories.title string

title