Zgłaszanie nieodpowiednich treści

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

Chociaż Google wdrożyło szereg środków, aby identyfikować problematyczne treści, zanim zostaną zwrócone przez Places API (New), udostępniamy też użytkownikom sposób na zgłaszanie 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, w tym unikalny identyfikator treści, który umożliwia użytkownikom powiadamianie Google o nieodpowiednich treściach.

Załóżmy, że 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ą opinią 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 w polu flagContentUri zawiera unikalny identyfikator treści. Kliknięcie tego linku spowoduje otwarcie strony internetowej hostowanej przez Google w formie:

Strona internetowa do zgłaszania problemów.

W tym oknie użytkownicy mogą przesłać do Google zgłoszenie dotyczące odpowiedniego typu problemu. Mogą na przykład zgłosić wulgaryzmy, dręczenie 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ż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 następującą 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. Po kliknięciu tego linku klienci mogą zgłosić nieodpowiednie treści w konkretnej 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, dopóki nie zostaną usunięte treści, do których prowadzą. Linki nadal otwierają okno w przypadku treści, które zostały usunięte, ale zgłoszenie treści, które zostały już usunięte, 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. Kliknij ikonę interfejsu API Rozwiń narzędzie APIs Explorer. po prawej stronie.

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

  3. Opcjonalnie zmodyfikuj treść żądania.

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

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