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 Gemini-Modellfunktionen für die Places API (Neu) verwenden, kann die Antwort außerdem 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 für den entsprechenden Problemtyp bei Google einreichen. Sie können beispielsweise vulgäre Sprache, Mobbing oder rechtliche Probleme 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 präsentieren, damit Ihre Kunden etwaige Probleme mit Inhalten melden können.

Über die Antwort auf den Link zum Melden von Inhalten zugreifen

Die folgende Anfrage vom Typ „Place Details (New)“ enthält Rezensionen zum Ort 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 die jeweilige Rezension. Wenn Ihre Kunden diesen Link aufrufen, können sie unangemessene Inhalte für diese bestimmte 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, 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 weiterhin das Dialogfeld für entfernte Inhalte geöffnet. Das Melden von bereits entfernten Inhalten 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. 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 Bereich „API Explorer“ das Symbol zum Maximieren Maximieren Sie den API Explorer. aus, um das API Explorer-Fenster zu maximieren.