AI エージェント向けガイド

AI エージェント向け Google クチコミリンク API

1 件の Google マップ URL をクチコミ投稿用の直接リンクに変換します。登録や Google API キーは不要です。

  1. リクエスト

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. レスポンス 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

正しいマップ URL の取得方法

  1. Google マップで正確な店舗を開きます。
  2. 支店名と住所を確認し、共有を選択します。
  3. リンクをコピーし、maps_url として送信します。

支店が不明な場合は、正確な場所をユーザーに確認してください。推測したり、結果が検証済みだと伝えたりしないでください。

リクエスト

エンドポイントに 1 つの JSON オブジェクトを送信します。店舗名や Place ID だけの入力には対応していません。

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

レスポンス

verification は常に not_verified です。ユーザーに渡す前に場所を確認してください。

API リファレンス →

エラーと対処方法

エッジで生成された 429 レスポンスには JSON や Retry-After がない場合があります。60 秒以上待ち、その後は待機時間を延ばしてください。

エラーと対処方法 →

データの利用

成功した呼び出しでは、場所の識別子、言語、時刻、および取得できる場合は店舗のおおよその位置を記録します。展開した短縮 URL は24時間キャッシュされます。