API リファレンス

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

対応する入力

  • 特定の場所を示す完全な Google マップ URL
  • maps.app.goo.gl の共有リンク
  • 従来の goo.gl/maps 共有リンク

リクエスト

エンドポイントに 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"}'

レスポンス

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

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

エラーと対処方法

  • invalid_request (400)
    空でない maps_url を含む有効な JSON を送信してください。
  • unsupported_url (422)
    Google マップの特定店舗の共有リンクを使用してください。
  • unsafe_redirect (422)
    Google マップだけに転送される共有リンクを使用してください。
  • upstream_unresolved (502)
    短縮リンクを開き、最終的な完全なマップ URL を送信してください。
  • upstream_timeout (504)
    待ってから一度再試行するか、最終的な完全なマップ URL を送信してください。

利用制限

匿名利用はクライアント IP ごとに毎分約 20 リクエストです。同じ IP を使うエージェントはこの枠を共有します。

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

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

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

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

データの利用

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