Uygunsuz içeriği bildirme

Places API, yanıttaki bir yer hakkında bilgi döndürür. Yanıt, adres ve telefon numarası gibi gerçek içeriklerin yanı sıra kullanıcıların Google Haritalar'a katkıda bulunduğu yorum ve fotoğraf gibi içerikleri de içerebilir. Ayrıca, Places API için Gemini model özelliklerini kullandığınızda yanıt, bir LLM'den toplanan ve özetlenen üretken veriler içerebilir.

Google, sorunlu içeriği Places API'si tarafından döndürülmeden önce tespit etmek amacıyla bir dizi önlem almış olsa da, kullanıcıların uygunsuz içeriği işaretleyerek Google'ın kaldırabilmesi için bir yöntem de sunar. Bu sürümle birlikte Places API'si, Places API yanıtına dahil edilen tüm yorumlara, fotoğraflara ve üretken özetlere yeni flagContentUri alanını dahil edecektir. Bu alanda, kullanıcıların Google'ı uygunsuz içerik hakkında bilgilendirmesine olanak tanıyan, benzersiz bir içerik tanımlayıcısı içeren bir bağlantı bulunur.

Örneğin, bir yer için beş ayrı yorum döndüren bir istek gönderirseniz Her yorum, kullanıcıların yorumların herhangi biriyle veya tümüyle ilgili sorunları bildirebilmesi için söz konusu yoruma ait benzersiz tanımlayıcı içeren yeni flagContentUri alanını içerir.

API Gezgini, bu yeni seçeneklerle tanışabilmeniz için canlı istek göndermenize olanak tanır:

Deneyin.

Bağlantı biçimi

flagContentUri alanındaki URL, içeriğin benzersiz tanımlayıcısını içerir. Bu bağlantıya göz atarak Google tarafından barındırılan bir web sayfasını şu şekilde açabilirsiniz:

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

Fiyatlandırma

Bu özellik, GKST öncesi önizleme aşamasındadır ve ücretsizdir. Yani önizleme sırasında kullanım için faturalandırma 0 ABD dolarıdır. Önerilen fiyatlandırma hakkında ayrıntılı bilgi için Places API Kullanımı ve Faturalandırması başlıklı makaleyi inceleyin.

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

Bu önizleme sürümü, Places API yanıtının bir parçası olan aşağıdaki nesnelere yeni flagContentUri alanını ekler:

• Review
• Photo

• GenerativeSummary Yalnızca GenerativeSummary için iki yeni alan vardır:

  • overviewFlagContentUri: Genel bakıştaki uygunsuz içerik hakkında Google'ı bilgilendirmek için kullanılacak bağlantı.
  • descriptionFlagContentUri: Açıklamadaki uygunsuz içerik hakkında Google'ı bilgilendirmek için kullanılacak bağlantı.

• AreaSummary

• ContextualContent

Önizleme döneminde, bu öğeleri müşterilerinize gösterdiğinizde içerik raporlama bağlantısını göstermeniz gerekmez.

Ancak bu özellik Genel Kullanım'a (GA) sunulduğunda, müşterilerinizin içerik sorunlarını bildirebilmesi için bu nesneleri gösterirken içerik bildirme bağlantısını göstermeniz gerekir.

Yanıtta yer alan içerik bildirme bağlantısına erişme

Aşağıdaki yer ayrıntıları 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 şekildedir:

{
  "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ını içeren flagContentUri alanını içerir. Bu bağlantıya göz atarak müşterileriniz, söz konusu yorumdaki uygunsuz içeriği bildirebilir.

Alan maskesine photos 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ıt, her öğenin flagContentUri alanını içerdiği photos dizisini de içerir:

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

Bağlantının geçerlilik süresi

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

Deneyin!

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için örnek istekler göndermenize olanak tanır.

1. Sayfanın sağ tarafındaki API simgesini seçin.

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

3. İsteğe bağlı olarak İstek gövdesini 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 seçin.