Unangemessene Inhalte melden

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

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

Sie stellen beispielsweise 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, sodass ein Nutzer ein Problem mit einer oder allen Rezensionen melden kann.

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

Testen!

Die URL im Feld flagContentUri enthält eine eindeutige Kennzeichnung 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 Ihre Nutzer einen Bericht zu dem entsprechenden Problemtyp bei Google einreichen. Sie können beispielsweise vulgäre Sprache, Mobbing oder ein rechtliches Problem mit den Inhalten melden.

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

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

Die folgende „Place Details (New)“-Anfrage enthält Ortsrezensionen 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 das folgende 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 mit einer eindeutigen Kennung für die jeweilige Rezension. Über diesen Link können Ihre Kunden unangemessene Inhalte für die jeweilige Rezension melden.

Wenn Sie photos in die Feldmaske einfügen:

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, in dem 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 Inhaltslinks bleiben aktiv, bis die zugrunde liegenden Inhalte entfernt werden. Über die Links wird weiterhin das Dialogfeld für entfernte Inhalte geöffnet. Das Einreichen einer Meldung für bereits entfernte Inhalte hat jedoch keine Auswirkungen.

Testen!

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

  1. Klicken Sie rechts auf der Seite auf das API-Symbol Maximieren Sie den API Explorer..

  2. Optional können Sie Standardparameter anzeigen maximieren und den Parameter fields auf die Feldmaske festlegen.

  3. Bearbeiten Sie optional den Anfragetext.

  4. Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

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