Melaporkan konten tidak pantas

Places API menampilkan informasi tentang tempat dalam respons. Selain konten faktual, seperti alamat dan nomor telepon, respons juga dapat berisi konten yang telah dikontribusikan pengguna di Google Maps, seperti ulasan dan foto. Selain itu, saat Anda menggunakan kemampuan model Gemini untuk Places API, respons dapat menyertakan data generatif yang digabungkan dan diringkas dari LLM.

Meskipun Google telah menerapkan serangkaian tindakan untuk mengidentifikasi konten yang bermasalah sebelum ditampilkan oleh Places API, kami juga menyediakan cara bagi pengguna untuk menandai konten yang tidak pantas sehingga Google dapat menghapusnya. Dengan rilis ini, Places API menyertakan kolom flagContentUri baru di semua ulasan, foto, dan ringkasan generatif yang disertakan dalam respons Places API. Kolom ini berisi link, termasuk ID konten unik, yang memungkinkan pengguna memberi tahu Google tentang konten yang tidak pantas.

Misalnya, Anda membuat permintaan yang menampilkan lima ulasan individual untuk suatu tempat. Setiap ulasan individu menyertakan kolom flagContentUri baru dengan ID unik untuk ulasan tersebut sehingga pengguna dapat melaporkan masalah pada salah satu atau semua ulasan.

API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami opsi baru ini:

Cobalah!

URL yang terdapat di kolom flagContentUri menyertakan ID unik untuk konten. Membuka link ini akan membuka halaman web yang dihosting Google dalam bentuk:

Halaman web laporkan masalah.

Dari dialog ini, pengguna Anda dapat mengajukan laporan ke Google untuk jenis masalah yang sesuai. Misalnya, mereka dapat melaporkan kata-kata tidak sopan, penindasan, atau masalah hukum terkait konten tersebut.

Harga

Fitur ini berada dalam tahap Pratinjau pra-GA dan tidak dikenai biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau. Untuk mengetahui detail harga yang diusulkan, lihat Penggunaan dan Penagihan Places API.

Menampilkan link pelaporan konten

Rilis Pratinjau ini menambahkan kolom flagContentUri baru ke objek berikut yang sudah menjadi bagian dari respons Places API:

  • Review
  • Photo

  • GenerativeSummary Khusus untuk GenerativeSummary, ada dua kolom baru:

    • overviewFlagContentUri: Link untuk memberi tahu Google tentang konten yang tidak pantas dalam ringkasan.
    • descriptionFlagContentUri: Link untuk memberi tahu Google tentang konten yang tidak pantas dalam deskripsi.

  • AreaSummary

  • ContextualContent

Selama periode Pratinjau, Anda tidak diwajibkan untuk menampilkan link pelaporan konten saat menampilkan objek ini kepada pelanggan.

Namun, saat fitur ini tersedia secara umum (GA), Anda harus menampilkan link pelaporan konten saat menampilkan objek ini agar pelanggan dapat melaporkan masalah konten apa pun.

Mengakses link pelaporan konten dalam respons

Permintaan Place Details berikut menyertakan ulasan tempat dalam respons:

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

Responsnya dalam bentuk:

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

Setiap entri dalam array reviews berisi kolom flagContentUri, termasuk ID unik untuk ulasan tertentu tersebut. Dengan membuka link tersebut, pelanggan dapat melaporkan konten yang tidak pantas untuk ulasan tertentu.

Jika Anda menyertakan photos dalam mask kolom:

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

Respons juga menyertakan array photos dengan setiap elemen berisi kolom 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"
    },
    ...
  ]

Link konten akan tetap aktif hingga konten pendukung dihapus. Link tersebut akan terus membuka dialog untuk konten yang telah dihapus, tetapi membuat laporan tentang konten yang telah dihapus tidak akan berdampak apa pun.

Cobalah!

API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.

  1. Pilih ikon API, Luaskan API Explorer., di sisi kanan halaman.

  2. Jika ingin, luaskan Tampilkan parameter standar dan tetapkan parameter fields ke mask kolom.

  3. Jika ingin, edit Isi permintaan.

  4. Pilih tombol Execute. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.

  5. Di panel API Explorer, pilih ikon luaskan, Luaskan API Explorer., untuk meluaskan jendela API Explorer.