檢舉不當內容

Places API 會在回應中傳回地點資訊。除了地址和電話號碼等事實內容，回應內容也可能包含使用者在 Google 地圖上提供的內容，例如評論和相片。此外，如果您使用 Places API 的 Gemini 模型功能，回應可能會包含從 LLM 匯總和匯入的生成式資料。

雖然 Google 已實施一系列措施，在 Places API 傳回問題內容前加以識別，但我們也提供一種方法，讓使用者標記不當內容，以便 Google 移除這些內容。在這個版本中，Places API 會在所有評論、相片和 Places API 回應中產生的摘要中，加入新的 flagContentUri 欄位。這個欄位包含連結，其中包含專屬內容 ID，可讓使用者向 Google 回報不當內容。

舉例來說，您提出的要求會傳回某個地點的五則個別評論。每則評論都包含新的 flagContentUri 欄位，其中包含該評論的專屬 ID，方便使用者針對任何或所有評論回報問題。

您可以透過 API Explorer 提出即時要求，熟悉這些新選項：

試試看！

flagContentUri 欄位中的網址包含內容專屬 ID。點選這個連結會開啟 Google 代管的網頁，格式如下：

「回報問題」網頁。

使用者可以透過這個對話方塊，向 Google 回報適當的問題類型。例如，他們可以檢舉不雅用語、霸凌行為或內容中的法律問題。

定價

這項功能目前處於正式發布前預覽階段，因此在預覽期間使用時不會產生費用，也就是帳單金額為 $0。如要進一步瞭解建議的定價，請參閱「Places API 用量與計費」一文。

顯示內容回報連結

這個預先發布版會在下列已納入 Places API 回應的物件中，新增 flagContentUri 欄位：

在預覽期間，您向客戶顯示這些物件時，不必顯示內容回報連結。

不過，當這項功能正式發布 (GA) 時，您必須在顯示這些物件時顯示內容回報連結，以便客戶回報任何內容問題。

在回覆中存取內容檢舉連結

以下 Place Details 要求會在回應中加入地點評論：

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 欄位，其中包含該特定評論的專屬 ID。點選該連結後，客戶就能針對該評論檢舉不當內容。

如果您在欄位遮罩中加入 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. 選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

  5. 在 API Explorer 面板中，選取展開圖示 展開 API Explorer。 來展開 API Explorer 視窗。