Zgłaszanie nieodpowiednich treści

Interfejs Places API (nowy) zwraca w odpowiedzi informacje o miejscu. Oprócz treści faktograficznych, takich jak adres i numer telefonu, odpowiedź może też zawierać treści przesłane przez użytkowników w Mapach Google, np. opinie i zdjęcia. Dodatkowo, gdy używasz funkcji modelu Gemini w interfejsie Places API (nowym), odpowiedź może zawierać dane generatywne zagregowane i podsumowane przez duży model językowy.

Google wdrożyło szereg środków, aby identyfikować problematyczne treści, zanim zostaną one zwrócone przez interfejs Places API (nowy). Umożliwiamy też użytkownikom oznaczanie nieodpowiednich treści, aby Google mogło je usunąć. W tej wersji interfejs Places API (nowy) zawiera nowe pole flagContentUri we wszystkich opiniach, zdjęciach i podsumowaniach generatywnych zawartych w odpowiedzi interfejsu Places API (nowego). To pole zawiera link z unikalnym identyfikatorem treści, który umożliwia użytkownikom zgłaszanie Google nieodpowiednich treści.

Na przykład wysyłasz żądanie, które zwraca 5 opinii o miejscu. Każda opinia zawiera nowe pole flagContentUri z unikalnym identyfikatorem, dzięki czemu użytkownik może zgłosić problem z dowolną lub wszystkimi opiniami.

Narzędzie API Explorer umożliwia wysyłanie żądań w czasie rzeczywistym, dzięki czemu możesz zapoznać się z tymi nowymi opcjami:

Wypróbuj

Adres URL zawarty w polu flagContentUri zawiera unikalny identyfikator treści. Kliknięcie tego linku otwiera w przeglądarce stronę internetową hostowaną przez Google w postaci:

strona internetowa zgłaszania problemów.

W tym oknie użytkownicy mogą zgłosić Google problem odpowiedniego typu. Mogą na przykład zgłosić wulgaryzmy, nękanie lub problem prawny związany z treścią.

Wyświetlanie linku do zgłaszania treści

Pole flagContentUri jest dostępne w tych obiektach, które są już częścią odpowiedzi interfejsu Places API (nowego):

Podczas wyświetlania tych obiektów musisz wyświetlać link do zgłaszania treści, aby Twoi klienci mogli zgłaszać wszelkie problemy z treścią.

Dostęp do linku do zgłaszania treści w odpowiedzi

Poniższe żądanie informacji o miejscu (nowe) zawiera w odpowiedzi opinie o miejscu:

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

Odpowiedź ma postać:

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

Każdy wpis w tablicy reviews zawiera pole flagContentUri z unikalnym identyfikatorem tej opinii. Kliknięcie tego linku umożliwia klientom zgłaszanie nieodpowiednich treści w tej opinii.

Jeśli w masce pola uwzględnisz photos:

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

Odpowiedź zawiera też tablicę photos, w której każdy element zawiera pole 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"
    },
    ...
  ]

Linki do treści pozostają aktywne do momentu usunięcia treści źródłowej. Linki nadal otwierają okno dialogowe dotyczące usuniętych treści, ale zgłoszenie problemu z treścią, która została już usunięta, nie przyniesie żadnego efektu.

Wypróbuj

Narzędzie APIs Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

  1. Po prawej stronie strony kliknij ikonę interfejsu API, Rozwiń API Explorer..

  2. Opcjonalnie rozwiń Pokaż parametry standard1owe i ustaw parametr fields na maskę pola.

  3. Opcjonalnie edytuj treść żądania.

  4. Kliknij przycisk Wykonaj. W oknie wybierz konto, którego chcesz użyć do wysłania żądania.

  5. W panelu API Explorer kliknij ikonę rozwijania, Rozwiń API Explorer., aby rozwinąć okno API Explorer.