Uygunsuz içeriği bildirme

Places API (Yeni), bir yanıtla birlikte bir yer hakkında bilgi döndürür. Yanıt, adres ve telefon numarası gibi somut bilgilerin yanı sıra kullanıcıların Google Haritalar'da paylaştığı yorumlar ve fotoğraflar gibi içerikleri de kapsayabilir. Ayrıca, Places API (Yeni) için Gemini modeli özelliklerini kullandığınızda yanıtta, bir LLM'den toplanan ve özetlenen üretken veriler yer alabilir.

Google, sorunlu içerikleri Places API (Yeni) tarafından döndürülmeden önce tespit etmek için bir dizi önlem almıştır. Ayrıca, kullanıcıların uygunsuz içerikleri işaretleyerek Google'ın bu içerikleri kaldırmasını sağlayabileceği bir yöntem de sunar. Bu sürümle birlikte Places API (Yeni), Places API (Yeni) yanıtına dahil edilen tüm yorum, fotoğraf ve üretken özetlerde yeni flagContentUri alanını içerir. Bu alanda, kullanıcıların uygunsuz içerikleri Google'a bildirmesine olanak tanıyan, benzersiz bir içerik tanımlayıcı içeren bir bağlantı bulunur.

Örneğin, bir yer için beş ayrı yorum döndüren bir istekte bulunursunuz. Her bir inceleme, kullanıcının incelemelerin herhangi biri veya tümüyle ilgili bir sorunu bildirebilmesi için o incelemeye ait benzersiz bir tanımlayıcı içeren yeni flagContentUri alanını içerir.

API Gezgini, bu yeni seçenekleri tanıyabilmeniz için canlı istekler göndermenize olanak tanır:

Deneyin.

flagContentUri alanındaki URL, içerik için benzersiz bir tanımlayıcı içerir. Bu bağlantıya göz attığınızda, Google tarafından 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 bir sorunu bildirebilirler.

İçerik bildirme bağlantısını gösterme

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ıttaki içerik bildirme bağlantısına erişme

Aşağıdaki Yer Ayrıntıları (Yeni) isteği, yanıtta 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 yorumun benzersiz tanımlayıcısı da dahil olmak üzere flagContentUri alanını içerir. Müşterileriniz bu bağlantıya giderek söz konusu yorumla ilgili uygunsuz içerik bildiriminde bulunabilir.

Alan maskesine photos değerini eklerseniz:

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çerikler için iletişim kutusunu açmaya devam eder ancak kaldırılmış içerikler hakkında bildirimde bulunmanın bir etkisi olmaz.

Deneyin.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz 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 maskesine ayarlayın.

  3. İsterseniz İstek gövdesi'ni düzenleyebilirsiniz.

  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.