Zgłaszanie nieodpowiednich treści

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

Chociaż Google wdrożyło szereg środków, które pozwalają wykrywać problematyczne treści, zanim zostaną one zwrócone przez interfejs Places API (nowy), udostępniamy też użytkownikom możliwość zgłaszania nieodpowiednich treści, abyśmy mogli je usunąć. W tej wersji interfejs Places API (nowy) zawiera nowe pole flagContentUri we wszystkich opiniach, zdjęciach i podsumowaniach generatywnych uwzględnionych w odpowiedzi interfejsu Places API (nowego). To pole zawiera link, w tym unikalny identyfikator treści, który umożliwia użytkownikom zgłaszanie do Google nieodpowiednich treści.

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

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. Otwarcie tego linku spowoduje wyświetlenie strony internetowej hostowanej przez Google w formacie:

Strona internetowa zgłaszania problemów.

W tym oknie użytkownicy mogą zgłosić problem do Google, wybierając odpowiedni typ problemu. Mogą na przykład zgłosić wulgaryzmy, nękanie lub problem prawny związany z treściami.

Wyświetlanie linku do zgłaszania treści

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

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

Kliknij link do zgłaszania treści w odpowiedzi.

Poniższa prośba o szczegóły miejsca (nowa) 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, w tym unikalny identyfikator konkretnej opinii. Kliknięcie tego linku umożliwia klientom zgłaszanie nieodpowiednich treści w konkretnej opinii.

Jeśli w masce pola umieścisz znak 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 pozostaną aktywne do momentu usunięcia treści źródłowych. Linki nadal otwierają okno dialogowe w przypadku usuniętych treści, ale zgłoszenie treści, które zostały już usunięte, nie przynosi żadnego efektu.

Wypróbuj

Narzędzie API 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ń narzędzie API Explorer..

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

  3. Opcjonalnie edytuj treść żądania.

  4. Kliknij przycisk Wykonaj. W oknie dialogowym wybierz konto, którego chcesz użyć do wysłania prośby.

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