举报不当内容

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

虽然 Google 已实施一系列措施来识别 Places API (New) 返回的问题内容,但我们也为用户提供了一种标记不当内容的方式,以便 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 窗口。