Đánh giá Google

Khách tìm doanh nghiệp bạn trên Google hay Maps thì thứ họ đọc đầu tiên là đánh giá. MADIAD Hub đọc được toàn bộ đánh giá của một địa điểm và đăng câu trả lời của chủ, qua đúng kết nối Google mà Profile đang dùng để đăng bài Google Business. Không cần cấp thêm quyền nào.

Cần Profile đã kết nối Google Business. Xem Kết nối kênh.

Liệt kê địa điểm

Một tài khoản Google có thể sở hữu nhiều địa điểm. Gọi endpoint này trước để lấy location_id.

curl "https://api.madiad.com/v1/gbp/locations?profile_id=$PROFILE_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Đọc đánh giá

Kênh áp dụng: chỉ Google Business. Đánh giá trên Facebook, TikTok Shop hay sàn thương mại điện tử không đọc được qua đây.

curl "https://api.madiad.com/v1/gbp/reviews?profile_id=$PROFILE_ID&location_id=locations/1578..." \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Tham số	Bắt buộc	Ghi chú
`profile_id`	Có	Profile của bạn
`location_id`	Tuỳ	Bỏ trống được nếu Profile chỉ có một địa điểm, hoặc đã chọn địa điểm mặc định lúc kết nối Google Business
`pageSize` · `pageToken`	Không	Phân trang; `pageToken` lấy từ `nextPageToken` của lần gọi trước
`orderBy`	Không	Ví dụ `updateTime desc`, `rating desc`

Phản hồi kèm averageRating và totalReviewCount của địa điểm. Mỗi đánh giá có trường name là đường dẫn đầy đủ, và đó chính là thứ bạn truyền vào khi trả lời.

Nếu Profile có nhiều hơn một địa điểm mà bạn không truyền location_id, Hub dùng địa điểm mặc định đã chọn lúc kết nối Google Business. Chưa có địa điểm mặc định thì yêu cầu trả về 400 với code: "location_required" kèm danh sách địa điểm: tự chọn giùm bạn một địa điểm nghĩa là có ngày trả lời công khai nhầm cửa hàng. Trường location_source trong phản hồi cho biết đã áp dụng cách nào (requested, only_location hoặc connection_default), location_id là địa điểm đã dùng, còn locations liệt kê mọi địa điểm của Profile (location_id + title).Một location_id không thuộc Profile trả về 404.

Trả lời một đánh giá

Trả lời đánh giá cần gói Business trở lên, cùng nhóm với nhắn tin riêng và AutoDM. Đọc đánh giá thì mọi gói đang hoạt động đều được.Khác với trả lời bình luận, vốn có từ gói Starter: một bình luận nằm dưới bài của chính bạn, còn một đánh giá nằm trên hồ sơ Google của doanh nghiệp và câu trả lời đứng đó lâu dài bên cạnh điểm sao.

curl -X POST https://api.madiad.com/v1/gbp/reviews/reply \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "'$PROFILE_ID'",
    "review_name": "accounts/1180.../locations/1578.../reviews/AbFvOqk",
    "comment": "Cảm ơn anh đã dành thời gian viết đánh giá. Hẹn gặp lại anh."
  }'

Truyền review_name (lấy nguyên văn từ danh sách đánh giá) hoặc cặp review_id + location_id. Dùng review_name gọn hơn: địa điểm đã nằm sẵn trong đường dẫn nên không thể lệch. Gọi lại lần nữa trên cùng một đánh giá sẽ thay câu trả lời cũ, không tạo thêm câu mới.

Bắt đầu

Khái niệm

Tích hợp

Tham chiếu API

Liệt kê địa điểm

Đọc đánh giá

Trả lời một đánh giá

​Liệt kê địa điểm

​Đọc đánh giá

​Trả lời một đánh giá

Liệt kê địa điểm

Đọc đánh giá

Trả lời một đánh giá