Unangemessene Inhalte melden

Die Places API (New) gibt in einer Antwort Informationen zu einem Ort zurück. Neben sachlichen Inhalten wie einer Adresse und Telefonnummer kann die Antwort auch Inhalte enthalten, die Nutzer auf Google Maps beigetragen haben, z. B. Rezensionen und Fotos. Wenn Sie die Gemini-Modellfunktionen für die Places API (New) verwenden, kann die Antwort außerdem generative Daten enthalten, die von einem LLM zusammengefasst wurden.

Google hat eine Reihe von Maßnahmen ergriffen, um problematische Inhalte zu identifizieren, bevor sie von der Places API (New) zurückgegeben werden. Außerdem bieten wir Nutzern die Möglichkeit, unangemessene Inhalte zu melden, damit Google sie entfernen kann. Mit diesem Release enthält die Places API (New) das neue Feld flagContentUri in allen Rezensionen, Fotos und generativen Zusammenfassungen, die in einer Places API (New)-Antwort enthalten sind. Dieses Feld enthält einen Link, einschließlich einer eindeutigen Inhalts-ID, über den Nutzer Google über unangemessene Inhalte informieren können.

Beispiel: Sie stellen eine Anfrage, die fünf einzelne Rezensionen für einen Ort zurückgibt. Jede einzelne Rezension enthält das neue Feld flagContentUri mit einer eindeutigen Kennung für diese Rezension, damit Nutzer ein Problem mit einer oder allen Rezensionen melden können.

Mit dem APIs Explorer können Sie Liveanfragen stellen, um sich mit diesen neuen Optionen vertraut zu machen:

Testen!

Die URL im Feld flagContentUri enthält eine eindeutige Kennung für den Inhalt. Wenn Sie diesen Link aufrufen, wird eine von Google gehostete Webseite im folgenden Format geöffnet:

Die Webseite „Problem melden“.

In diesem Dialogfeld können Nutzer einen Bericht für den entsprechenden Problemtyp an Google senden. Sie können beispielsweise vulgäre Sprache, Mobbing oder ein rechtliches Problem mit den Inhalten melden.

Link zum Melden von Inhalten anzeigen

Das Feld flagContentUri ist in den folgenden Objekten verfügbar, die bereits Teil der Antwort der Places API (New) sind:

Sie müssen den Link zum Melden von Inhalten anzeigen, wenn Sie diese Objekte anzeigen, damit Ihre Kunden Probleme mit Inhalten melden können.

Link zum Melden von Inhalten in der Antwort aufrufen

Die folgende Place Details (New)-Anfrage enthält Rezensionen in der Antwort:

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

Die Antwort hat folgendes Format:

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

Jeder Eintrag im reviews-Array enthält das Feld flagContentUri, einschließlich einer eindeutigen Kennung für diese bestimmte Rezension. Über diesen Link können Ihre Kunden unangemessene Inhalte für diese bestimmte Rezension melden.

Wenn Sie photos in die Feldmaske aufnehmen:

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

Die Antwort enthält auch das photos-Array, wobei jedes Element das Feld flagContentUri enthält:

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

Die Links zu den Inhalten bleiben aktiv, bis die zugrunde liegenden Inhalte entfernt werden. Über die Links wird das Dialogfeld für entfernte Inhalte weiterhin geöffnet. Das Melden von bereits entfernten Inhalten hat jedoch keine Auswirkungen.

Testen!

Mit dem API Explorer können Sie Beispielanfragen erstellen, um sich mit der API und den API-Optionen vertraut zu machen.

  1. Wählen Sie auf der rechten Seite der Seite das API-Symbol Maximieren Sie den API Explorer. aus.

  2. Maximieren Sie optional Standardparameter anzeigen und legen Sie den Parameter fields auf die Feldmaske fest.

  3. Bearbeiten Sie optional den Anfragetext.

  4. Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

  5. Wählen Sie im API Explorer-Bereich das Symbol zum Maximieren Maximieren Sie den API Explorer. aus, um das API Explorer-Fenster zu maximieren.