プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Googleマップのレビューの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordに指定した名前や業種で、Google Maps上の場所を検索します。GoogleのプレイスID、住所、座標、電話番号、Webサイト、評価、レビュー数、閉業状況を取得できます。page_tokenでページングし、合計最大120件まで取得できます。60件を超える場合は非同期モードが必要です。 | 1,000リクエストあたり$1.39 | 正常 |
スポット詳細profile | 完全なurlからGoogle Mapsの場所を取得します。住所、Plus Code、座標、電話番号、Webサイト、評価、レビュー数、営業時間、臨時休業または閉業の状況が含まれます。URLはsearchで取得したものを推奨します。名前と座標だけのリンクでは、同じビジネスと一致しない場合があります。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Google Mapsの1つの場所のレビューを読み取ります。各レビューには評価、投稿者名とその投稿者のレビュー数、ローカルガイドバッジ、いいね数、写真、項目別の評価、オーナーからの返信（ある場合）が含まれます。langで言語を選び、page_tokenでページングでき、最大400件まで取得できます。200件を超える場合は非同期モードが必要です。 | 1,000リクエストあたり$1.39 | 正常 |
投稿者のレビューcontributor_reviews | contributorにプロフィールのリンクまたは数値IDを指定して、Google Mapsの1人のユーザーが書いたレビューを取得します。各レビューには評価、本文、いいね数、写真、オーナーからの返信（ある場合）に加え、対象の場所（名前、住所、種類、座標）と、レビュアーのレビュー数およびローカルガイドのレベルが含まれます。日付は「13時間前」のような相対表記でposted_agoに入ります。デフォルトは20件、最大200件です。 | 1,000リクエストあたり$1.39 | 正常 |
ビジネス掲載情報business_listings | categoryにdentistやcoffee_shopなどのカテゴリを指定してGoogle Mapsからビジネスを取得し、city、country、最低評価、ビジネス名に含まれる単語で絞り込めます。各ビジネスには住所、座標、電話番号、Webサイト、評価、レビュー数が含まれます。取得件数は最大20件で、レビュー数の多い順に並びます。価格は空の場合が多く、閉業状況は提供されません。 | 1,000リクエストあたり$15.36 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Googleマップのレビューの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | country, language, location, page_token | Sync配信 | カタログ値：defaultLimit=15、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 次のページを取得するには、他のパラメータは変えずにnext_page_tokenをpage_tokenとして渡します。1ページにつき1回の呼び出しです。 1ページあたり最大120行です。60行を超える場合は、mode=asyncでページをリクエストしてください。 | 1,000リクエストあたり$1.39 | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
profileスポット詳細 完全な | url | city, language, since, sort | Sync配信 | — | 1,000リクエストあたり$1.39 | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform |
reviewsレビュー Google Mapsの1つの場所のレビューを読み取ります。各レビューには評価、投稿者名とその投稿者のレビュー数、ローカルガイドバッジ、いいね数、写真、項目別の評価、オーナーからの返信（ある場合）が含まれます。 | url | lang, language, page_token, since, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 次のページを取得するには、他のパラメータは変えずにnext_page_tokenをpage_tokenとして渡します。1ページにつき1回の呼び出しです。 1ページあたり最大400行です。200行を超える場合は、mode=asyncでページをリクエストしてください。 | 1,000リクエストあたり$1.39 | id · text · rating · rating_scale · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform |
contributor_reviews投稿者のレビュー
| contributor | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、200が上限として適用されます。 | 1,000リクエストあたり$1.39 | id · text · rating · rating_scale · like_count · posted_at · posted_ago · url · image_urls · owner_response · owner_response_ago · place_name · place_address · place_type · place_data_id · lat · lng · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · local_guide_level · local_guide_points · platform |
business_listingsビジネス掲載情報
| category | city, country, min_rating, name | Sync配信 | カタログ値：defaultLimit=20、maxLimit=20。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、20が上限として適用されます。 | 1,000リクエストあたり$15.36 | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
Googleマップのレビューのsearchのパラメータはそれぞれどういう意味ですか？
keywordに指定した名前や業種で、Google Maps上の場所を検索します。GoogleのプレイスID、住所、座標、電話番号、Webサイト、評価、レビュー数、閉業状況を取得できます。page_tokenでページングし、合計最大120件まで取得できます。60件を超える場合は非同期モードが必要です。
keyword必須- Google Mapsの場所名、業種、または場所のクエリです（例：
dentist、dentist in Chicago）。searchは場所を検索するもので、既存のビジネスのレビュー本文を検索するものではありません。 country任意- 検索のコンテキストを設定する国または地域のコードです（例：
us）。デフォルトはusです。返されるすべてのビジネスがその国に所在することを保証するものではありません。 language任意- クエリまたはページコンテンツに使用する言語で、デフォルトは
enです。reviewsでは、両方を指定した場合langがこの値より優先されます。この設定は、すべてのレビューがその言語で書かれていることを保証するものではありません。 location任意searchでkeywordと組み合わせる場所のテキストです（例：Chicago）。キーワードにすでに含まれている場所と矛盾する場所は指定しないでください。page_token任意- ページネーショントークンです。次のページを取得するには、前回のレスポンスのnext_page_tokenを渡します。最初のページでは省略してください。他のパラメータはすべて変更しないでください。トークンの有効期限は24時間で、1ページごとに1回の呼び出しとなります。
Googleマップのレビューのprofileのパラメータはそれぞれどういう意味ですか？
完全なurlからGoogle Mapsの場所を取得します。住所、Plus Code、座標、電話番号、Webサイト、評価、レビュー数、営業時間、臨時休業または閉業の状況が含まれます。URLはsearchで取得したものを推奨します。名前と座標だけのリンクでは、同じビジネスと一致しない場合があります。
url必須- Google Mapsの場所の完全なURLで、searchで返された、
query_place_idが保持されたURLを推奨します。名前と座標のみを含む/place/URLでは、同じビジネスを確実に特定できない場合があります。場所の詳細にはprofileを、その場所のレビューにはreviewsを使用してください。Googleマップ：場所のリンクとプレイスID — Googleマップのリンクでは`query_place_id`を使って特定の場所を直接指定するため、場所の名前や座標だけに頼る必要がありません。 · 確認日 city任意- 場所の検索に使う都市の条件です。profileアクションでもこのパラメータを指定できますが、既知のビジネスを別の都市に移すことはできず、場所のURLの代わりとして確実に機能するものでもありません。
language任意- クエリまたはページコンテンツに使用する言語で、デフォルトは
enです。reviewsでは、両方を指定した場合langがこの値より優先されます。この設定は、すべてのレビューがその言語で書かれていることを保証するものではありません。 since任意- レビューの投稿日の下限で、
YYYY-MM-DD形式を推奨します。ビジネスの開業日ではありません。profileアクションにこのパラメータがあっても、場所の詳細が開業日で絞り込まれるわけではありません。 sort任意- レビューの並び順です。
newestは新しいレビュー順、relevanceはプラットフォームの関連度順です。reviewsのデフォルトはnewestです。profileでは、同じ名前のパラメータが付随するレビューデータに影響する場合がありますが、単一の場所オブジェクトを並べ替えるものではありません。指定可能な値:newestrelevance
Googleマップのレビューのreviewsのパラメータはそれぞれどういう意味ですか？
Google Mapsの1つの場所のレビューを読み取ります。各レビューには評価、投稿者名とその投稿者のレビュー数、ローカルガイドバッジ、いいね数、写真、項目別の評価、オーナーからの返信（ある場合）が含まれます。langで言語を選び、page_tokenでページングでき、最大400件まで取得できます。200件を超える場合は非同期モードが必要です。
url必須- Google Mapsの場所の完全なURLで、searchで返された、
query_place_idが保持されたURLを推奨します。名前と座標のみを含む/place/URLでは、同じビジネスを確実に特定できない場合があります。場所の詳細にはprofileを、その場所のレビューにはreviewsを使用してください。Googleマップ：場所のリンクとプレイスID — Googleマップのリンクでは`query_place_id`を使って特定の場所を直接指定するため、場所の名前や座標だけに頼る必要がありません。 · 確認日 lang任意- reviewsの言語オプションです（例：
en、zhcn、zhtw）。指定できる値はアクションの完全な一覧を参照してください。languageより優先されます。レビュー投稿者の国籍で絞り込むものではありません。指定可能な値:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu language任意- クエリまたはページコンテンツに使用する言語で、デフォルトは
enです。reviewsでは、両方を指定した場合langがこの値より優先されます。この設定は、すべてのレビューがその言語で書かれていることを保証するものではありません。 page_token任意- ページネーショントークンです。次のページを取得するには、前回のレスポンスのnext_page_tokenを渡します。最初のページでは省略してください。他のパラメータはすべて変更しないでください。トークンの有効期限は24時間で、1ページごとに1回の呼び出しとなります。
since任意- レビューの投稿日の下限で、
YYYY-MM-DD形式を推奨します。ビジネスの開業日ではありません。profileアクションにこのパラメータがあっても、場所の詳細が開業日で絞り込まれるわけではありません。 sort任意- レビューの並び順です。
newestは新しいレビュー順、relevanceはプラットフォームの関連度順です。reviewsのデフォルトはnewestです。profileでは、同じ名前のパラメータが付随するレビューデータに影響する場合がありますが、単一の場所オブジェクトを並べ替えるものではありません。指定可能な値:newestrelevance
Googleマップのレビューのcontributor_reviewsのパラメータはそれぞれどういう意味ですか？
contributorにプロフィールのリンクまたは数値IDを指定して、Google Mapsの1人のユーザーが書いたレビューを取得します。各レビューには評価、本文、いいね数、写真、オーナーからの返信（ある場合）に加え、対象の場所（名前、住所、種類、座標）と、レビュアーのレビュー数およびローカルガイドのレベルが含まれます。日付は「13時間前」のような相対表記でposted_agoに入ります。デフォルトは20件、最大200件です。
contributor必須- Google Mapsのレビュー投稿者で、プロフィールリンク（https://www.google.com/maps/contrib/<numeric ID>）または10〜32桁のIDのみで指定します。
reviewsの結果に含まれる投稿者リンクはこのページにつながります。contributor_reviewsは、この投稿者が書いたレビューを最大200件返します。
Googleマップのレビューのbusiness_listingsのパラメータはそれぞれどういう意味ですか？
categoryにdentistやcoffee_shopなどのカテゴリを指定してGoogle Mapsからビジネスを取得し、city、country、最低評価、ビジネス名に含まれる単語で絞り込めます。各ビジネスには住所、座標、電話番号、Webサイト、評価、レビュー数が含まれます。取得件数は最大20件で、レビュー数の多い順に並びます。価格は空の場合が多く、閉業状況は提供されません。
category必須business_listingsで使用するGoogle Mapsのビジネスカテゴリで、スペースをアンダースコアに置き換えた小文字の英語で指定します（例：dentist、coffee_shop、italian_restaurant）。city任意- ビジネスの住所と照合する都市名です（例：
Austin）。その都市以外のビジネスは除外されます。 country任意- ビジネスの住所と照合する2文字の国コードです（例：
us、gb）。 min_rating任意business_listingsで残す最低の星評価で、1〜5で指定します。4.5などの小数も使用できます。name任意business_listingsでビジネス名に含まれている必要がある語（ブランド名など）です。名前にこの語を含まないビジネスは除外されます。
Googleマップのレビュー APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Googleマップのレビューのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
Google MapsレビューAPI：適切な入口を選び、店舗のレビューを記録する
Business Profile、Places API、EveryInfraによる店舗レビュー取得の違いを整理し、店舗の同一性、言語、期間フィルターを検証し、評価や店舗返信の変更履歴を保存して、サンプル・保存・表示の範囲を明確にします。
記事を読むGoogle Maps店舗データの重複排除：Place IDは恒久的な事業者IDではない
同じ場所に複数のPlace IDが存在することがあり、IDは時間とともに変わることもあります。本ガイドでは公式ドキュメントをもとに、チェーン店の重複排除、社内エンティティとのマッピング、移転履歴、誤統合の検証方法を解説します。
記事を読むマルチプラットフォームの評判モニタリング設計：ネガティブな変化を評価する前に範囲を決める
監視対象リスト、コメントの識別子、増分カーソルを起点に、追跡可能な評判モニタリングのワークフローを設計します。オフラインのサンプルで重複排除と取り込み漏れを示しつつ、人によるレビューを維持します。
記事を読むGoogleマップのレビュー APIに関する質問
Googleマップのレビュー APIでは何を取得できますか？
platformをgoogle_maps_reviewsに設定します。現在のカタログには検索、スポット詳細、レビュー、投稿者のレビュー、ビジネス掲載情報が掲載されています。これらのアクション名はそれぞれ異なるGoogleマップのレビューのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Googleマップのレビューのsearchリクエストを開始するには、どの入力を使用しますか？
Google Mapsの場所名、業種、または場所のクエリです（例：dentist、dentist in Chicago）。searchは場所を検索するもので、既存のビジネスのレビュー本文を検索するものではありません。params内のkeywordとして送信してください。
Googleマップのレビューのsearchはどのフィールドを返しますか？
宣言されたスキーマにはplace_id、name、category、categoriesが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Googleマップのレビューのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。