> ## Documentation Index
> Fetch the complete documentation index at: https://docs.madiad.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Đánh giá Google

> Đọc đánh giá trên Google Business Profile và trả lời công khai bằng chủ tài khoản.

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.

<Note>
  Cần Profile đã kết nối **Google Business**. Xem [Kết nối kênh](/vi/concepts/channels).
</Note>

## 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`.

```bash theme={null}
curl "https://api.madiad.com/v1/gbp/locations?profile_id=$PROFILE_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"
```

## Đọc đánh giá

<Note>
  **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.
</Note>

```bash theme={null}
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.

<Warning>
  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`.
</Warning>

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

<Note>
  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](/vi/concepts/engagement), 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.
</Note>

```bash theme={null}
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.