Segnalare contenuti inappropriati

L'API Places (New) restituisce informazioni su un luogo in una risposta. Oltre ai contenuti fattuali, come un indirizzo e un numero di telefono, la risposta può contenere anche contenuti che gli utenti hanno contribuito su Google Maps, come recensioni e foto. Inoltre, quando utilizzi le funzionalità del modello Gemini per l'API Places (New), 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 consentire agli utenti di segnalare 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 notificare a Google i contenuti inappropriati.

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

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

Fai una prova!

L'URL contenuto nel campo flagContentUri include un identificatore univoco per i contenuti. Se fai clic su 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 contenuti osceni, 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):

Devi visualizzare il link per la segnalazione dei contenuti quando visualizzi questi oggetti in modo che i tuoi clienti possano segnalare eventuali problemi con i contenuti.

Accedere al link per la segnalazione dei contenuti nella risposta

La seguente richiesta di Dettagli luogo (New) include le recensioni dei luoghi 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 fai clic su questo link, i tuoi clienti possono segnalare contenuti inappropriati per quella recensione specifica.

Se includi photos nella maschera dei campi:

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 backup non vengono rimossi. I link continuano ad aprire la finestra di dialogo per i contenuti rimossi, ma la segnalazione di contenuti già rimossi non ha alcun effetto.

Fai una prova!

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

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

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

  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 Explorer API.