Báo cáo nội dung không phù hợp

Places API (Mới) trả về thông tin về một địa điểm trong phản hồi. Cùng với nội dung thực tế, chẳng hạn như địa chỉ và số điện thoại, phản hồi cũng có thể chứa nội dung mà người dùng đã đóng góp trên Google Maps, chẳng hạn như bài đánh giá và ảnh. Ngoài ra, khi bạn sử dụng các chức năng của mô hình Gemini cho Places API (Mới), phản hồi có thể bao gồm dữ liệu tạo sinh được tổng hợp và tóm tắt từ một LLM.

Mặc dù Google đã triển khai một loạt biện pháp để xác định nội dung có vấn đề trước khi nội dung đó được Places API (Mới) trả về, nhưng chúng tôi cũng cung cấp một cách để người dùng gắn cờ nội dung không phù hợp để Google có thể xoá nội dung đó. Trong bản phát hành này, Places API (Mới) có thêm trường flagContentUri mới trong tất cả bài đánh giá, ảnh và bản tóm tắt tạo sinh có trong phản hồi của Places API (Mới). Trường này chứa một đường liên kết, bao gồm cả giá trị nhận dạng nội dung riêng biệt, cho phép người dùng thông báo cho Google về nội dung không phù hợp.

Ví dụ: bạn đưa ra một yêu cầu trả về 5 bài đánh giá riêng lẻ cho một địa điểm. Mỗi bài đánh giá riêng lẻ đều có trường flagContentUri mới với một giá trị nhận dạng riêng biệt cho bài đánh giá đó để người dùng có thể báo cáo vấn đề với bất kỳ hoặc tất cả bài đánh giá.

API Explorer cho phép bạn đưa ra yêu cầu trực tiếp để có thể làm quen với các lựa chọn mới sau:

Hãy làm thử!

URL có trong trường flagContentUri bao gồm một giá trị nhận dạng riêng biệt cho nội dung. Khi bạn duyệt đến đường liên kết này, một trang web do Google lưu trữ sẽ mở ra dưới dạng:

Trang web báo cáo sự cố.

Trong hộp thoại này, người dùng có thể gửi báo cáo cho Google về loại vấn đề phù hợp. Ví dụ: họ có thể báo cáo ngôn từ tục tĩu, hành vi bắt nạt hoặc vấn đề pháp lý liên quan đến nội dung.

Hiển thị đường liên kết báo cáo nội dung

Trường flagContentUri có trong các đối tượng sau đây, vốn đã có trong phản hồi của Places API (Mới):

Bạn phải hiển thị đường liên kết báo cáo nội dung khi hiển thị các đối tượng này để khách hàng có thể báo cáo mọi vấn đề về nội dung.

Truy cập vào đường liên kết báo cáo nội dung trong câu trả lời

Yêu cầu sau đây về Place Details (Mới) bao gồm các bài đánh giá về địa điểm trong phản hồi:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Phản hồi có dạng:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
      "relativePublishTimeDescription": "7 months ago",
      "rating": 3,
      "text": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "originalText": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "John Smith",
        "uri": "https://www.google.com/maps/contrib/10198693/reviews",
        "photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
      },
      "publishTime": "2024-02-24T19:26:18.091264Z",
      "flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    …
  ]
}

Mỗi mục nhập trong mảng reviews chứa trường flagContentUri, bao gồm cả giá trị nhận dạng riêng biệt cho bài đánh giá cụ thể đó. Khi truy cập vào đường liên kết đó, khách hàng có thể báo cáo nội dung không phù hợp cho bài đánh giá cụ thể đó.

Nếu bạn đưa photos vào mặt nạ trường:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews,photos" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Nội dung phản hồi cũng bao gồm mảng photos, trong đó mỗi phần tử chứa trường flagContentUri:

  ...
  "photos": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
      "widthPx": 4032,
      "heightPx": 3024,
      "authorAttributions": [
        {
          "displayName": "Jane Smith",
          "uri": "https://maps.google.com/maps/contrib/107007354",
          "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
        }
      ],
      "flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    ...
  ]

Các đường liên kết đến nội dung vẫn hoạt động cho đến khi nội dung sao lưu bị xoá. Các đường liên kết vẫn tiếp tục mở hộp thoại cho nội dung đã bị xoá, nhưng việc gửi báo cáo về nội dung đã bị xoá sẽ không có hiệu lực.

Hãy dùng thử!

API Explorer cho phép bạn tạo các yêu cầu mẫu để làm quen với API và các tuỳ chọn API.

  1. Chọn biểu tượng API (Mở rộng APIs Explorer.) ở bên phải trang.

  2. Bạn có thể mở rộng mục Hiện tham số chuẩn và đặt tham số fields thành mặt nạ trường.

  3. Chỉnh sửa Nội dung yêu cầu (không bắt buộc).

  4. Chọn nút Execute (Thực thi). Trong hộp thoại, hãy chọn tài khoản mà bạn muốn dùng để gửi yêu cầu.

  5. Trong bảng điều khiển API Explorer, hãy chọn biểu tượng mở rộng Mở rộng APIs Explorer. để mở rộng cửa sổ API Explorer.