举报不当内容

Places API(新版)会在响应中返回地点的相关信息。 除了地址和电话号码等事实内容外,响应还可能包含用户在 Google 地图上贡献的内容,例如评价和照片。此外,当您使用 Places API(新版)的 Gemini 模型功能时,响应中可能包含从 LLM 汇总和总结的生成式数据。

尽管 Google 已实施一系列措施,以便在 Places API(新版)返回有问题的内容之前将其识别出来,但我们也为用户提供了一种标记不当内容的方法,以便 Google 将其移除。在此版本中,Places API(新版)在 Places API(新版)响应中包含的所有评价、照片和生成式摘要中都添加了新的 flagContentUri 字段。此字段包含一个链接(包括唯一内容标识符),可让用户向 Google 举报不当内容。

例如,您发出一个请求,该请求会返回某个地点的五条单独评价。每条评价都包含新的 flagContentUri 字段,其中包含该评价的唯一标识符,以便用户可以报告任何或所有评价的问题。

借助 API Explorer,您可以发出实时请求,以便熟悉以下新选项:

试试看!

flagContentUri 字段中包含的网址包含内容的唯一标识符。浏览此链接会打开一个由 Google 托管的网页,其格式如下:

“报告问题”网页。

用户可以通过此对话框向 Google 提交相应问题类型的报告。例如,他们可以举报内容中存在的粗言秽语、霸凌或法律问题。

flagContentUri 字段可在以下对象中使用,这些对象已包含在 Places API(新版)响应中:

您必须在显示这些对象时显示内容举报链接,以便客户可以举报任何内容问题。

以下地点详情(新版)请求会在响应中包含地点评价:

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

响应采用以下形式:

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

reviews 数组中的每个条目都包含 flagContentUri 字段,其中包括该特定评价的唯一标识符。客户浏览该链接后,可以举报特定评价属于不当内容。

如果您在字段掩码中添加 photos:

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

响应还包含 photos 数组,其中每个元素都包含 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"
    },
    ...
  ]

在移除底层内容之前,内容链接会一直有效。这些链接确实会继续打开对话框,以便您举报已移除的内容,但举报已移除的内容不会产生任何效果。

试试看!

借助 API Explorer,您可以发出示例请求,以便熟悉 API 和 API 选项。

  1. 选择页面右侧的 API 图标 展开 API Explorer。。

  2. (可选)展开显示标准参数,并将 fields 参数设置为字段掩码。

  3. (可选)修改请求正文。

  4. 选择执行按钮。在对话框中,选择您要用于发出请求的账号。

  5. 在 API Explorer 面板中,选择展开图标 展开 API Explorer。 以展开 API Explorer 窗口。