Segnalare contenuti inappropriati

L'API Places (New) restituisce informazioni su un luogo in una risposta. Oltre a contenuti oggettivi, come un indirizzo e un numero di telefono, la risposta può contenere anche contenuti forniti dagli utenti su Google Maps, come recensioni e foto. Inoltre, quando utilizzi le funzionalità del modello Gemini per l'API Places (nuova), la risposta può includere dati generativi aggregati e riepilogati da un LLM.

Sebbene Google abbia implementato una serie di misure per identificare i contenuti problematici prima che vengano restituiti dall'API Places (New), forniamo anche un modo per gli utenti di segnalare i contenuti inappropriati in modo che Google possa rimuoverli. Con questa release, l'API Places (New) include il nuovo campo flagContentUri in tutte le recensioni, le foto e i riepiloghi generativi inclusi in una risposta dell'API Places (New). Questo campo contiene un link, incluso un identificatore di contenuti univoco, che consente agli utenti di segnalare a Google contenuti inappropriati.

Ad esempio, invii una richiesta che restituisce cinque recensioni individuali per un luogo. Ogni singola recensione include il nuovo campo flagContentUri con un identificatore univoco per la recensione, in modo che un utente possa segnalare un problema con una o tutte le recensioni.

L'API Explorer ti consente di effettuare richieste in tempo reale per familiarizzare con queste nuove opzioni:

Prova!

L'URL contenuto nel campo flagContentUri include un identificatore univoco per i contenuti. Se navighi a questo link, si apre una pagina web ospitata da Google nel formato:

La pagina web Segnala un problema.

Da questa finestra di dialogo, gli utenti possono presentare una segnalazione a Google per il tipo di problema appropriato. Ad esempio, possono segnalare linguaggio volgare, bullismo o un problema legale con i contenuti.

Visualizzare il link per la segnalazione dei contenuti

Il campo flagContentUri è disponibile nei seguenti oggetti che fanno già parte della risposta dell'API Places (New):

Quando visualizzi questi oggetti, devi mostrare il link per la segnalazione dei contenuti in modo che i tuoi clienti possano segnalare eventuali problemi.

Accedere al link per la segnalazione dei contenuti nella risposta

La seguente richiesta Place Details (New) include le recensioni del luogo nella risposta:

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 risposta è nel 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"
    },
    …
  ]
}

Ogni voce dell'array reviews contiene il campo flagContentUri, incluso un identificatore univoco per quella recensione specifica. Se i tuoi clienti visitano questo link, possono segnalare contenuti inappropriati per quella recensione specifica.

Se includi photos nella maschera del campo:

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 risposta include anche l'array photos, in cui ogni elemento contiene il 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"
    },
    ...
  ]

I link ai contenuti rimangono attivi finché i contenuti di supporto non vengono rimossi. I link continuano ad aprire la finestra di dialogo per i contenuti rimossi, ma la presentazione di una segnalazione relativa a contenuti già rimossi non ha alcun effetto.

Prova

Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.

  1. Seleziona l'icona API, Espandi Explorer API., sul lato destro della pagina.

  2. (Facoltativo) Espandi Mostra parametri standard e imposta il parametro fields sulla maschera del campo.

  3. (Facoltativo) Modifica il corpo della richiesta.

  4. Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi utilizzare per effettuare la richiesta.

  5. Nel riquadro Explorer API, seleziona l'icona di espansione, Espandi Explorer API., per espandere la finestra di Explorer API.