此页面由 Cloud Translation API 翻译。

举报不当内容

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

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

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

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

试试看！

链接格式

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

“报告问题”网页。

在该对话框中，用户可以向 Google 提交适当的问题类型报告。例如，他们可以举报内容中的亵渎性、欺凌行为或法律问题。

价格

此功能目前处于 GA 发布前的预览阶段，在预览期间使用不收费，也就是说，结算金额为 0 美元。如需详细了解拟议的价格，请参阅 Places API 使用和结算。

显示内容举报链接

此预览版将新的 flagContentUri 字段添加到已包含在 Google 地图 API 响应中的以下对象：

Review
Photo
GenerativeSummary 仅 GenerativeSummary 新增了两个字段：
- overviewFlagContentUri：用于在概览中通知 Google 不当内容的链接。
- descriptionFlagContentUri：用于通知 Google 说明中包含不当内容的链接。
AreaSummary
ContextualContent

在预览期间，您向客户展示这些对象时，无需显示内容举报链接。

不过，当此功能正式发布 (GA) 后，您在展示这些对象时必须显示内容举报链接，以便客户举报任何内容问题。

访问回复中的内容举报链接

以下地点详情请求的响应中包含地点评价：

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 选项。

选择页面右侧的 API 图标。
（可选）展开显示标准参数，然后将 fields 参数设置为字段掩码。
您可以视需要修改请求正文。
选择执行按钮。在对话框中，选择您要使用哪个账号发出请求。
在 API Explorer 面板中，选择展开图标以展开 API Explorer 窗口。