AI 代理專用指南

供 AI 代理使用的 Google 評論連結 API

將一個 Google 地圖網址轉換為直接評論連結。無需註冊或 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

取得正確的地圖網址

  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"}'

回應

verification 固定為 not_verified。將連結交給使用者前，請確認地點。

API 參考 →

錯誤與處理方式

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

錯誤與處理方式 →

資料使用

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