Zgłaszanie nieodpowiednich treści

Interfejs Places API (New) zwraca w odpowiedzi informacje o miejscu. Oprócz treści faktycznych, takich jak adres i numer telefonu, odpowiedź może zawierać też treści przesłane przez użytkowników w Mapach Google, np. opinie i zdjęcia. Poza tym, gdy używasz możliwości modelu Gemini w interfejsie Places API (Nowy), odpowiedź może zawierać dane generatywne zagregowane i podsumowywane z modelu LLM.

Chociaż wdrożyliśmy już szereg środków, które umożliwiają identyfikację problematycznych treści przed ich zwróceniem przez interfejs Places API (nowy), umożliwiamy też użytkownikom oznaczanie nieodpowiednich treści, abyśmy mogli je usunąć. W tej wersji interfejsu Places API (New) we wszystkich opiniach, zdjęciach i generowanych podsumowaniach uwzględniono nowe pole flagContentUri w odpowiedziach zwracanych przez interfejs Places API (New). 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 pojedynczych opinii dotyczących danego miejsca. Każda opinia zawiera nowe pole flagContentUri z unikalnym identyfikatorem, dzięki któremu użytkownik może zgłosić problem dotyczący dowolnej lub wszystkich opinii.

Narzędzie API Explorer umożliwia wysyłanie żądań na żywo, 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 spowoduje otwarcie strony internetowej hostowanej przez Google w postaci:

Strona zgłaszania problemów

W tym oknie użytkownicy mogą przesłać do Google zgłoszenie dotyczące odpowiedniego typu problemu. Możesz 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 interfejsu Places API (New):

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

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

W odpowiedzi na to żądanie dotyczące szczegółów miejsca (Nowe) znajdują się 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. Po kliknięciu tego linku klienci mogą zgłaszać nieodpowiednie treści w przypadku 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 do momentu usunięcia treści źródłowych. Linki te nadal otwierają okno dotyczące treści, które zostały usunięte, ale przesłanie zgłoszenia dotyczącego treści, które zostały już usunięte, nie przyniesie ż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ż parametry standardowe i ustaw parametr fields na maskę pola.

  3. Opcjonalnie możesz zmodyfikować tekst prośby.

  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ń narzędzie API Explorer., aby rozwinąć okno API Explorer.