檢舉不當內容

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 回報適當的問題類型。例如,他們可以檢舉不雅用語、霸凌行為或內容相關法律問題。

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. 您可以選擇展開「顯示標準參數」,然後將 fields 參數設為欄位遮罩

  3. 您可以選擇編輯要求主體

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

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