Zgłaszanie nieodpowiednich treści

Interfejs Places API zwraca w odpowiedzi informacje o miejscu. Oprócz treści faktycznych, takich jak adres i numer telefonu, odpowiedź może zawierać również treści przesłane przez użytkowników w Mapach Google, takie jak opinie i zdjęcia. Ponadto, gdy używasz możliwości modelu Gemini w przypadku interfejsu Places API, odpowiedź może zawierać dane generatywne zagregowane i podsumowywane z modelu LLM.

Chociaż wdrożyliśmy już szereg środków, które pozwalają zidentyfikować problematyczne treści, zanim zostaną one zwrócone przez Places API, umożliwiamy też użytkownikom oznaczanie nieodpowiednich treści, abyśmy mogli je usunąć. W tej wersji interfejsu Places API pole flagContentUri jest dostępne we wszystkich opiniach, zdjęciach i generowanych podsumowaniach zawartych w odpowiedzi interfejsu Places API. To pole zawiera link, w tym unikalny identyfikator treści, który umożliwia użytkownikom zgłaszanie Google nieodpowiednich treści.

Na przykład wysyłasz żądanie, które zwraca 5 indywidualnych opinii dotyczących danego miejsca. Każda opinia zawiera nowe pole flagContentUri z unikatowym identyfikatorem, dzięki czemu 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

Format linku

Adres URL zawarty w polu flagContentUri zawiera niepowtarzalny identyfikator treści. Kliknięcie tego linku powoduje otwarcie strony internetowej hostowanej przez Google w formie:

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

Ceny

Ta funkcja jest na etapie wstępnej wersji przed GA i jest bezpłatna, co oznacza, że za korzystanie z niej w wersji wstępnej nie są naliczane opłaty. Szczegółowe informacje o proponowanych cenach znajdziesz w artykule Korzystanie z interfejsu Places API i rozliczenia.

Wyświetlanie linku do zgłaszania treści

Ta wersja w podglądzie dodaje nowe pole flagContentUri do tych obiektów, które są już częścią odpowiedzi interfejsu Places API:

• Review
• Photo

• GenerativeSummary W przypadku usługi GenerativeSummary dostępne są 2 nowe pola:

  • overviewFlagContentUri: link do powiadomienia Google o nieodpowiednim treściach w podsumowaniu.
  • descriptionFlagContentUri: link do powiadomienia Google o nieodpowiednim treściach w opisie.

• AreaSummary

• ContextualContent

W okresie podglądu nie musisz wyświetlać linku do raportowania treści, gdy wyświetlasz te obiekty klientom.

Gdy jednak ta funkcja stanie się ogólnie dostępna, musisz wyświetlać link do zgłaszania treści podczas wyświetlania tych obiektów, aby Twoi klienci mogli zgłaszać problemy z treściami.

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

W odpowiedzi na to żądanie dotyczące szczegółów miejsca 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. Przejście do tego linku umożliwia klientom zgłaszanie nieodpowiednich 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"
    },
    ...
  ]

Wygaśnięcie linku

Linki do treści pozostają aktywne do momentu usunięcia treści źródłowych. Linki te będą nadal otwierać 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 .

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

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

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