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

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

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

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

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

Попробуйте!

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

Страница "Сообщить о проблеме"

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

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

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

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

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

В следующем запросе на получение информации о местах (новый) в ответ включены отзывы о местах:

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. справа на странице.

  2. При желании разверните раздел «Показать стандартные параметры» и установите параметр fields в значение маски поля .

  3. При желании можно отредактировать текст запроса .

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

  5. В панели API Explorer выберите значок развертывания. Разверните обозреватель API. Чтобы развернуть окно API Explorer, нажмите здесь.