檢舉不當內容

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

雖然 Google 已採取一系列措施，在 Places API (新版) 傳回問題內容前加以識別，但我們也提供使用者檢舉不當內容的方法，以便 Google 移除。在這個版本中，Places API (新版) 的所有評論、相片和生成式摘要，都會包含新的 flagContentUri 欄位。這個欄位包含連結 (內含不重複的內容 ID)，可讓使用者向 Google 檢舉不當內容。

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

您可以使用 API Explorer 傳送即時要求，熟悉下列新選項：

試試看！

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

「回報問題」網頁。

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

顯示內容檢舉連結

flagContentUri 欄位可在下列物件中使用，這些物件已是 Places API (新版) 回應的一部分：

顯示這些物件時，您必須顯示內容檢舉連結，讓客戶可以檢舉任何內容問題。

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

下列 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. 視需要展開「Show standard parameters」(顯示標準參數)，並將 fields 參數設為欄位遮罩。

  3. 視需要編輯「Request body」(要求主體)。

  4. 選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

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