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 một phản hồi. Ngoài nội dung thực tế, chẳng hạn như địa chỉ và số điện thoại, câu trả lời cũng có thể chứa nội dung do 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 Places API (Mới) trả về nội dung đó, nhưng chúng tôi cũng cung cấp cho người dùng cách gắn cờ nội dung không phù hợp để Google có thể xoá nội dung đó. Với bản phát hành này, Places API (mới) sẽ bao gồ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 duy nhấ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 kèm theo một giá trị nhận dạng duy nhấ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 các yêu cầu trực tiếp để có thể làm quen với những lựa chọn mới này:

Hãy làm thử!

Định dạng đường liên kết

URL có trong trường flagContentUri chứa một giá trị nhận dạng riêng biệt cho nội dung. Việc duyệt xem đường liên kết này sẽ mở một trang web do Google lưu trữ ở dạng:

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 nội dung thô tục, 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 đã có trong phản hồi của Places API (mới):

• Review
• Photo
• GenerativeSummary
• NeighborhoodSummary
• EvChargeAmenitySummary
• ReviewSummary
• ContextualContent

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 phản hồi

Yêu cầu Chi tiết về địa điểm (Mới) sau đây 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 trong mảng reviews đều 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 duyệt xem đường liên kết đó, khách hàng có thể báo cáo nội dung không phù hợp trong bài đánh giá cụ thể đó.

Nếu bạn thêm 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

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"
    },
    ...
  ]

Ngày hết hạn của đường liên kết

Các đường liên kết đến nội dung sẽ vẫn hoạt động cho đến khi nội dung hỗ trợ bị gỡ bỏ. Các đường liên kết này vẫn 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ó tác dụng.

Hãy dùng thử!

API Explorer cho phép bạn đưa ra các yêu cầu mẫu để làm quen với API và các lựa chọn API.

1. Chọn biểu tượng API ở bên phải trang.

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

3. Bạn có thể chỉnh sửa Nội dung yêu cầu (không bắt buộc).

4. Chọn nút Thực thi. Trong hộp thoại, hãy chọn tài khoản mà bạn muốn dùng để đưa ra 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 cửa sổ API Explorer.