Yelp (独立発行者) (プレビュー)
Yelp コネクタにより、32 か国の数百万の企業から、最高のローカル コンテンツ、注目ポイント、およびユーザー レビューを取得することができます。
このコネクタは、次の製品および地域で利用可能です。
Service | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
お問い合わせ先 | |
---|---|
件名 | Ahmad Najjar |
メール | ahmadn82@hotmail.com |
Connector Metadata | |
---|---|
発行者 | Ahmad Najjar |
Web サイト | https://www.yelp.com/ |
プライバシー ポリシー | https://terms.yelp.com/privacy/ |
接続の作成
コネクタは、次の認証タイプをサポートしています:
既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
件名 | タイプ | Description | Required |
---|---|---|---|
YelpAPI キー | securestring | 「Bearer API_KEY」として Yelp API キーを指定します | True |
調整制限
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
オートコンプリート |
会社、検索キーワード、およびカテゴリのオートコンプリートの提案を提供します。 |
ビジネス マッチの検索 |
完全な入力場所に一致する Yelp の会社を検索します。 このアクションを使用して、他のソースからのビジネス データを Yelp の会社と照合します。 |
レビューの取得 |
ビジネスのレビューの抜粋を最大 3 つ取得します。 |
会社の検索 |
語句 (キーワード)、カテゴリ、場所、価格レベルなどで会社を検索します。名前や場所など、ビジネスに関する全般情報はあるが住所が分からない場合は、このアクションを使用します。 |
会社の詳細を取得する |
名前、住所、電話番号、写真、Yelp の評価、価格レベル、営業時間など、充実した会社データを取得します。 |
勤務先電話番号の検索 |
指定された電話番号に基づいて会社の一覧を返します。 このアクションは、電話番号しかない場合、または他の照合基準に確実性がない場合に使用します。 |
オートコンプリート
会社、検索キーワード、およびカテゴリのオートコンプリートの提案を提供します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テキスト
|
text | True | string |
オートコンプリートの提案を返すテキスト。 |
緯度
|
latitude | True | double |
会社向けのオートコンプリートの提案を取得する場合に必要です。 会社のオートコンプリートの提案を探す場所の緯度。 |
経度
|
longitude | True | double |
会社向けのオートコンプリートの提案を取得する場合に必要です。 会社のオートコンプリートの提案を探す場所の経度。 |
ロケール
|
locale | string |
既定 en_US。 (参照: https://bit.ly/3lwvIWU) |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
語句
|
terms | array of object |
語句 |
text
|
terms.text | string |
text |
会社
|
businesses | array of object |
会社 |
name
|
businesses.name | string |
name |
id
|
businesses.id | string |
id |
text
|
businesses.text | string |
text |
カテゴリ
|
categories | array of object |
カテゴリ |
エイリアス
|
categories.alias | string |
エイリアス |
役職
|
categories.title | string |
役職 |
ビジネス マッチの検索
完全な入力場所に一致する Yelp の会社を検索します。 このアクションを使用して、他のソースからのビジネス データを Yelp の会社と照合します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
件名
|
name | True | string |
会社の名前。 最大長は 64 で、数字、文字、スペース、および !#$%&+,�./:?@' のみが許可されています。 |
住所 1
|
address1 | True | string |
会社の住所の 1 行目。 最大長は 64 で、数字、文字、スペース、および ��/#&,.: のみが許可されています。 空の文字列 "" が許可されています。これは特に、番地がない特定のサービスの会社と一致します。 |
住所 2
|
address2 | string |
会社の住所の 2 行目。 最大長は 64 で、数字、文字、スペース、および ��/#&,.: のみが許可されています。 |
|
住所 3
|
address3 | string |
会社の住所の 3 行目。 最大長は 64 で、数字、文字、スペース、および ��/#&,.: のみが許可されています。 |
|
市
|
city | True | string |
会社の市区町村。 最大長は 64 で、数字、文字、スペース、および ��.() のみが許可されています。 |
州
|
state | True | string |
この会社の ISO 3166-2 (いくつかの例外を除く) 都道府県コード。 最大長は 3 です。 |
国
|
country | True | string |
この会社の ISO 3166-1 alpha-2 国コード。 最大長は 2 です。 |
緯度
|
latitude | double |
会社の WGS84 緯度 (10 進角)。 �-90 から +90 の間で指定してください。 |
|
経度
|
longitude | double |
会社の WGS84 軽度 (10 進角)。 �-180 から +180 の間で指定してください。 |
|
電話
|
phone | string |
(a) 地元の数字のみの形式 (例: 016703080)、または (b) 国際的な先頭の + 記号と後に続く数字のみ (+35316703080) で送信できる会社の電話番号。 最大長は 32 です。 |
|
Zip Code
|
zip_code | string |
会社の郵便番号。 |
|
Yelp Business ID
|
yelp_business_id | string |
利用可能な場合、会社の一意の Yelp 識別子。 一致する会社を見つけるときのヒントとして使用されます。 |
|
限度
|
limit | integer |
返される会社の結果の最大数。 既定では、3 つを返します。 最小で 1、最大で 10 です。 |
|
一致のしきい値
|
match_threshold | integer |
一致する会社に、一致の品質のしきい値を適用するかどうかを指定します。 「none」、「default」、または「strict」の 1 つである必要があります。 none: 一致の品質のしきい値を適用しません。潜在的な会社の一致すべてが返されます。 default: 一致の品質のしきい値を適用し、非常に近い一致の会社のみが返されるようにします。 strict: 非常に厳密な一致の品質のしきい値を適用します。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
|
array of object | ||
name
|
name | string |
name |
住所 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
|
id | string |
id |
エイリアス
|
alias | string |
エイリアス |
レビューの取得
ビジネスのレビューの抜粋を最大 3 つ取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
ID
|
id | True | string |
この会社の一意の Yelp ID。 |
Locale
|
locale | string |
Default en_US. (参照: https://bit.ly/3lwvIWU) |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
reviews
|
reviews | array of object |
reviews |
id
|
reviews.id | string |
id |
評価
|
reviews.rating | integer |
評価 |
id
|
reviews.user.id | string |
id |
profile_url
|
reviews.user.profile_url | string |
profile_url |
image_url
|
reviews.user.image_url | string |
image_url |
name
|
reviews.user.name | string |
name |
text
|
reviews.text | string |
text |
time_created
|
reviews.time_created | string |
作成時刻 |
url
|
reviews.url | string |
url |
total
|
total | integer |
total |
possible_languages
|
possible_languages | array of string |
使用可能な言語 |
会社の検索
語句 (キーワード)、カテゴリ、場所、価格レベルなどで会社を検索します。名前や場所など、ビジネスに関する全般情報はあるが住所が分からない場合は、このアクションを使用します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
用語 (キーワード)
|
term | True | string |
検索語句、たとえば「レストラン」。 この語句は、会社名の場合もあります。 |
場所
|
location | True | string |
会社を検索するときに使用される地理的領域。 例: ニューヨーク、NYC |
緯度
|
latitude | double |
近隣で検索したい場所の緯度。 |
|
経度
|
longtitude | double |
近隣で検索したい場所の経度。 |
|
半径
|
radius | integer |
メートル単位での推奨検索半径。 (最大: 40,000 m) |
|
カテゴリ
|
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 |
(既定 = false)。 true に設定した場合、現在開いている会社のみを返します。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
トータル
|
total | integer |
検索条件に基づいて Yelp が検索した会社の合計数。 値が 1,000 を超えることもあります。 この場合、複数のクエリおよび「limit」パラメーターと「offset」パラメーターの組み合わせを使用して、最大 1,000 の会社しか取得できません。 |
会社
|
businesses | array of object |
検索条件に基づいて Yelp が検索した会社の一覧。 |
レイティング
|
businesses.rating | float |
この会社の評価 (値の範囲は 1、1.5、... 4.5、5 から)。 |
価格
|
businesses.price | string |
会社の価格レベル。 値は、$、$$、$$$ および $$$$ の 1 つです。 |
電話番号
|
businesses.phone | string |
会社の電話番号。 |
ID
|
businesses.id | string |
この会社の一意の Yelp ID。 |
Alias
|
businesses.alias | string |
この会社の一意の Yelp エイリアス。 Unicode 文字を含めることができます。 例: "yelp-san-francisco" |
閉じています
|
businesses.is_closed | boolean |
会社が (完全に) クローズされたかどうか |
カテゴリ
|
businesses.categories | array of object |
この会社に関連づけられているカテゴリ タイトルとエイリアスのペアの一覧。 |
エイリアス
|
businesses.categories.alias | string |
特定のカテゴリで会社を検索する場合、カテゴリのエイリアスはタイトルではなくエイリアスを使用します。 |
役職
|
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 |
この会社の経度。 |
画像の 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 |
検索場所からのメートル単位の距離。 これは、ロケールに関係なくメーターを返します。 |
transactions
|
businesses.transactions | array of string |
会社が登録されている Yelp トランザクションの一覧。 現在サポートされている値は、pickup、delivery、restaurant_reservation です。 |
緯度
|
region.center.latitude | double |
マップ バウンド センターの緯度位置。 |
経度
|
region.center.longitude | double |
マップ バウンド センターの経度位置。 |
会社の詳細を取得する
名前、住所、電話番号、写真、Yelp の評価、価格レベル、営業時間など、充実した会社データを取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
ID
|
id | True | string |
この会社の一意の Yelp ID。 |
Locale
|
locale | string |
Default en_US. (参照: https://bit.ly/3lwvIWU) |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
id
|
id | string |
id |
alias
|
alias | string |
alias |
name
|
name | string |
name |
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 | array of object |
カテゴリ |
エイリアス
|
categories.alias | string |
エイリアス |
役職
|
categories.title | string |
役職 |
評価
|
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 |
end
|
hours.open.end | string |
end |
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 |
end
|
special_hours.end | string |
end |
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
勤務先電話番号の検索
指定された電話番号に基づいて会社の一覧を返します。 このアクションは、電話番号しかない場合、または他の照合基準に確実性がない場合に使用します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
電話
|
phone | True | string |
検索する会社の電話番号。 (+14159083801 など) |
ロケール
|
locale | string |
既定 en_US。 (参照: https://bit.ly/3lwvIWU) |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
total
|
total | integer |
total |
会社
|
businesses | array of object |
会社 |
評価
|
businesses.rating | float |
評価 |
価格
|
businesses.price | string |
価格 |
phone
|
businesses.phone | string |
phone |
id
|
businesses.id | string |
id |
エイリアス
|
businesses.alias | string |
エイリアス |
カテゴリ
|
businesses.categories | array of object |
カテゴリ |
エイリアス
|
businesses.categories.alias | string |
エイリアス |
役職
|
businesses.categories.title | string |
役職 |
review_count
|
businesses.review_count | integer |
review_count |
name
|
businesses.name | string |
name |
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 |
トランザクション |