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

トランザクション