檢舉不當內容

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 用量與計費」一文。

這個預先發布版會將新的 flagContentUri 欄位新增至下列已納入 Places API 回應的物件:

在預覽期間,當您向顧客顯示這些物件時,則不需要顯示內容報表連結。

不過,當這項功能正式發布 (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. 視需要展開「Show Standard parameters」,然後將 fields 參數設為欄位遮罩

  3. 視需要編輯「要求主體」

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

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