Denunciar contenido inapropiado

La API de Places (nueva) devuelve información sobre un lugar en una respuesta. Además del contenido fáctico, como una dirección y un número de teléfono, la respuesta también puede incluir contenido que los usuarios hayan aportado en Google Maps, como opiniones y fotos. Además, cuando usas las funciones del modelo de Gemini para la API de Places (nueva), la respuesta puede incluir datos generativos agregados y resumidos de un LLM.

Si bien Google implementó una serie de medidas para identificar el contenido problemático antes de que lo devuelva la API de Places (nueva), también proporcionamos una forma para que los usuarios marquen el contenido inapropiado para que Google pueda quitarlo. Con esta versión, la API de Places (nueva) incluye el nuevo campo flagContentUri en todas las opiniones, fotos y resúmenes generativos incluidos en una respuesta de la API de Places (nueva). Este campo contiene un vínculo, que incluye un identificador de contenido único, que permite que los usuarios notifiquen a Google sobre contenido inapropiado.

Por ejemplo, realizas una solicitud que devuelve cinco opiniones individuales sobre un lugar. Cada opinión individual incluye el nuevo campo flagContentUri con un identificador único para esa opinión, de modo que un usuario pueda informar un problema con alguna o todas las opiniones.

El Explorador de APIs te permite realizar solicitudes en tiempo real para que puedas familiarizarte con estas opciones nuevas:

Pruébalo

La URL que se incluye en el campo flagContentUri contiene un identificador único para el contenido. Si navegas a este vínculo, se abrirá una página web alojada en Google con el siguiente formato:

La página web para informar un problema

En este diálogo, los usuarios pueden enviar un informe a Google para el tipo de problema correspondiente. Por ejemplo, pueden denunciar lenguaje obsceno, bullying o un problema legal con el contenido.

Muestra el vínculo de denuncia de contenido

El campo flagContentUri está disponible en los siguientes objetos que ya forman parte de la respuesta de la API de Places (nueva):

Debes mostrar el vínculo de denuncia de contenido cuando muestres estos objetos para que tus clientes puedan denunciar cualquier problema con el contenido.

Accede al vínculo de denuncia de contenido en la respuesta

La siguiente solicitud de Place Details (nuevo) incluye opiniones sobre el lugar en la respuesta:

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

La respuesta tiene el siguiente formato:

{
  "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"
    },
    …
  ]
}

Cada entrada del array reviews contiene el campo flagContentUri, incluido un identificador único para esa opinión específica. Si tus clientes navegan a ese vínculo, podrán denunciar contenido inapropiado para esa opinión específica.

Si incluyes photos en la máscara de campo, ocurrirá lo siguiente:

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

La respuesta también incluye el array photos, en el que cada elemento contiene el campo 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"
    },
    ...
  ]

Los vínculos de contenido permanecen activos hasta que se quita el contenido de respaldo. Los vínculos siguen abriendo el diálogo para el contenido que se quitó, pero presentar una denuncia sobre el contenido que ya se quitó no tiene ningún efecto.

Pruébalo

El Explorador de APIs te permite realizar solicitudes de muestra para que puedas familiarizarte con la API y sus opciones.

  1. Selecciona el ícono de APIs, Expande el Explorador de APIs., en el lado derecho de la página.

  2. De manera opcional, expande Mostrar parámetros estándar y establece el parámetro fields en la máscara de campo.

  3. De manera opcional, edita el Cuerpo de la solicitud.

  4. Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que quieras usar para realizar la solicitud.

  5. En el panel del Explorador de APIs, selecciona el ícono de expansión, Expande el Explorador de APIs., para expandir la ventana del Explorador de APIs.