Uygunsuz içeriği bildirme

Places API (Yeni), bir yer hakkındaki bilgileri yanıtta döndürür. Yanıt, adres ve telefon numarası gibi gerçek içeriklerin yanı sıra kullanıcıların Google Haritalar'da katkıda bulunduğu içerikleri (ör. yorumlar ve fotoğraflar) de içerebilir. Ayrıca, Places API (Yeni) için Gemini model özelliklerini kullandığınızda yanıtta, LLM'den toplanıp özetlenen üretken veriler yer alabilir.

Google, Places API (Yeni) tarafından döndürülmeden önce sorunlu içerikleri belirlemek için bir dizi önlem almış olsa da kullanıcıların uygunsuz içerikleri işaretleyebileceği bir yöntem de sunuyoruz. Böylece Google, bu içerikleri kaldırabilir. Bu sürümle birlikte Places API (Yeni), Places API (Yeni) yanıtına dahil edilen tüm yorumlarda, fotoğraflarda ve üretken özetlerde yeni flagContentUri alanını içerir. Bu alanda, kullanıcıların Google'ı uygunsuz içeriklerden haberdar etmesini sağlayan benzersiz içerik tanımlayıcısı da dahil olmak üzere bir bağlantı yer alıyor.

Örneğin, bir yerle ilgili beş ayrı yorum döndüren bir istekte bulunursunuz. Her bir yorum, kullanıcıların yorumların herhangi biri veya tümüyle ilgili sorun bildirebilmesi için bu yoruma ait benzersiz bir tanımlayıcı içeren yeni flagContentUri alanını içerir.

API Gezgini, canlı istekler göndermenize olanak tanır. Böylece aşağıdaki yeni seçeneklere aşina olabilirsiniz:

Deneyin.

flagContentUri alanında bulunan URL, içeriğin benzersiz tanımlayıcısını içerir. Bu bağlantıya göz atıldığında, Google'da barındırılan bir web sayfası şu biçimde açılır:

Sorun bildirme web sayfası.

Kullanıcılarınız bu iletişim kutusundan uygun sorun türü için Google'a rapor gönderebilir. Örneğin, küfür, zorbalık veya içerikle ilgili yasal sorunları bildirebilirler.

İçerik bildirme bağlantısını görüntüleme

flagContentUri alanı, Places API (Yeni) yanıtında yer alan aşağıdaki nesnelerde kullanılabilir:

Müşterilerinizin içerikle ilgili sorunları bildirebilmesi için bu nesneleri gösterirken içerik bildirme bağlantısını da göstermeniz gerekir.

Yanıtın içerik bildirme bağlantısına erişme

Aşağıdaki Yer Ayrıntıları (Yeni) isteği, yanıttaki yer yorumlarını içerir:

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

Yanıt şu biçimdedir:

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

reviews dizisindeki her giriş, söz konusu yorum için benzersiz bir tanımlayıcı da dahil olmak üzere flagContentUri alanını içerir. Bu bağlantıya göz atan müşterileriniz, söz konusu yorumla ilgili uygunsuz içerikleri bildirebilir.

Alan maskesine photos ekliyorsanız:

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

Yanıtta, her öğenin flagContentUri alanını içerdiği photos dizisi de yer alır:

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

İçerik bağlantıları, destekleyici içerik kaldırılana kadar etkin kalır. Bağlantılar, kaldırılan içeriklerin iletişim kutusunu açmaya devam eder ancak zaten kaldırılmış içeriklerle ilgili rapor göndermenin herhangi bir etkisi olmaz.

Deneyin!

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

  1. Sayfanın sağ tarafındaki API simgesini API Gezgini'ni genişletin. seçin.

  2. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesi olarak ayarlayın.

  3. İsteğe bağlı olarak Request body'yi (İstek gövdesi) düzenleyin.

  4. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

  5. API Gezgini panelinde, API Gezgini penceresini genişletmek için genişlet simgesini (API Gezgini'ni genişletin.) seçin.