Denunciar contenido inapropiado

La API de Places (nuevo) devuelve información sobre un lugar en una respuesta. Junto con el contenido fáctico, como una dirección y un número de teléfono, la respuesta también puede contener contenido que los usuarios hayan aportado en Google Maps, como opiniones y fotos. Además, cuando usas las capacidades del modelo de Gemini para la API de Places (nueva), la respuesta puede incluir datos generativos agregados y resumidos a partir 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 (nuevo), también proporcionamos una forma para que los usuarios marquen el contenido inapropiado y Google pueda quitarlo. Con este lanzamiento, 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, incluido un identificador de contenido único, que permite a los usuarios notificar 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 cualquiera o todas las opiniones.

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

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:

Página web para informar un problema

Desde este diálogo, los usuarios pueden presentar un informe a Google sobre el tipo de problema adecuado. Por ejemplo, pueden denunciar lenguaje obsceno, hostigamiento o un problema legal con el contenido.

Mostrar el vínculo para denunciar contenido

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

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

Acceder al vínculo para denunciar 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 navegan a ese vínculo, tus clientes podrán denunciar contenido inapropiado en relación con esa opinión específica.

Si incluyes photos en la máscara de campo, haz 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 un informe 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 te familiarices con la API y sus opciones.

  1. Selecciona el ícono de la API, 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 deseas 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.