Google 評論連結 API

將一個 Google 地圖網址轉換為直接評論連結。無需註冊或 Google API 金鑰。

請先確認地點
API 會擷取識別碼並建立連結，但不會確認商家名稱、地址或是否可以評論。

支援的輸入
1. 特定地點的完整 Google 地圖網址
2. maps.app.goo.gl 分享連結
3. 舊版 goo.gl/maps 分享連結

取得正確的地圖網址
1. 在 Google 地圖開啟正確的商家地點。
2. 確認分店名稱與地址，再選擇分享。
3. 複製連結，並以 maps_url 傳送。

請求
向端點傳送一個 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): 開啟短連結，並傳送最終的完整地圖網址。
- upstream_timeout (504): 稍候再試一次，或傳送最終的完整地圖網址。

使用限制
匿名限制約為每個用戶端 IP 每分鐘 20 次請求。共用 IP 的代理會共用此額度。

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

邊緣產生的 429 回應可能沒有 JSON 內容或 Retry-After 標頭。請至少等候 60 秒，並逐次增加等候時間。

資料使用
成功的呼叫會記錄地點識別碼、語言、時間，以及可用時的商家大致位置。解析後的短網址會快取24小時。

Postman 集合: https://productmate.com/developers/google-review-link/postman.json

OpenAPI: https://productmate.com/developers/google-review-link/openapi.json

API 參考: https://productmate.com/zh-hant/developers/google-review-link

AI 代理專用指南: https://productmate.com/zh-hant/agents/google-review-link

開啟評論連結產生器: https://productmate.com/zh-hant/google-pinglun-lianjie-shengchengqi