举报不当内容

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

虽然 Google 已实施一系列措施，以便在 Places API（新）返回问题内容之前识别这些内容，但我们还提供了一种方法，让用户可以标记不当内容，以便 Google 将其移除。在此版本中，Places API（新）在 Places API（新）响应中包含的所有评价、照片和生成式摘要中添加了新的 flagContentUri 字段。此字段包含一个链接（包括唯一内容标识符），用户可以通过该链接向 Google 举报不当内容。

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

借助 APIs Explorer，您可以发出实时请求，以便熟悉这些新选项：

试试看！

链接格式

flagContentUri 字段中包含的网址包含内容的唯一标识符。浏览此链接会在 Google 托管的网页中打开以下表单：

用户可以通过此对话框向 Google 提交相应问题类型的报告。例如，他们可以举报内容中的脏话、欺凌行为或法律问题。

显示内容举报链接

flagContentUri 字段在以下对象中可用，这些对象已是 Places API（新）响应的一部分：

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

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

访问响应中的内容举报链接

注意： 如需查看使用 GenerativeSummary、NeighborhoodSummary、EvChargeAmenitySummary 和 ReviewSummary 的示例，请参阅 Places API（新）的 Gemini 模型功能。

以下“地点详情（新）”请求会在响应中包含地点评价：

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

链接失效

内容链接会一直处于有效状态，直到支持内容被移除。链接仍会打开已移除内容的对话框，但对已移除的内容提交报告没有任何效果。

试试看！

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

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

2. 您可以展开显示标准参数 ，并将 the fields parameter 设置为 field mask。

3. 您可以修改请求正文 。

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

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