Сообщить о неприемлемом контенте

API Places (новый) возвращает информацию о месте в ответе. Помимо фактического контента, такого как адрес и номер телефона, ответ может также содержать информацию, добавленную пользователями в Google Maps, например, отзывы и фотографии. Кроме того, при использовании возможностей модели Gemini для API Places (новый) ответ может включать генеративные данные, агрегированные и обобщенные из LLM.

Несмотря на то, что Google внедрил ряд мер для выявления проблемного контента до того, как он будет возвращен Places API (новый), мы также предоставляем пользователям возможность отмечать неприемлемый контент, чтобы Google мог его удалить. В этом выпуске Places API (новый) включает новое поле flagContentUri во всех отзывах, фотографиях и генеративных сводках, включаемых в ответ Places API (новый). Это поле содержит ссылку, включающую уникальный идентификатор контента, которая позволяет пользователям уведомлять Google о неприемлемом контенте.

Например, вы делаете запрос, который возвращает пять отдельных отзывов о месте. Каждый отдельный отзыв включает новое поле flagContentUri с уникальным идентификатором, чтобы пользователь мог сообщить о проблеме с любым или всеми отзывами.

API Explorer позволяет вам делать живые запросы, чтобы вы могли ознакомиться со следующими новыми возможностями:

Попробуйте!

URL-адрес, содержащийся в поле flagContentUri , содержит уникальный идентификатор контента. При переходе по этой ссылке открывается веб-страница, размещенная на Google, в следующем формате:

Веб-страница для сообщения о проблеме.

В этом диалоговом окне ваши пользователи могут отправить в Google жалобу на соответствующую проблему. Например, они могут сообщить о ненормативной лексике, издевательствах или юридических проблемах, связанных с контентом.

Отобразить ссылку для сообщения о нарушении

Поле flagContentUri доступно в следующих объектах, которые уже являются частью ответа API Places (новый):

При отображении этих объектов необходимо отображать ссылку для сообщения о проблемах с контентом, чтобы ваши клиенты могли сообщать о любых проблемах с контентом.

Перейдите по ссылке для сообщения о контенте в ответе.

Следующий запрос «Сведения о месте (новый)» включает в ответ отзывы о месте:

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 и его параметрами.

  1. Выберите значок API, Разверните API Explorer. , на правой стороне страницы.

  2. При необходимости разверните Показать стандартные параметры и задайте параметру fields маску поля .

  3. При желании отредактируйте тело запроса .

  4. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учётную запись, которую вы хотите использовать для отправки запроса.

  5. На панели обозревателя API выберите значок развертывания, Разверните API Explorer. , чтобы развернуть окно API Explorer.