گزارش محتوای نامناسب

Places API (جدید) اطلاعات یک مکان را در یک پاسخ برمی گرداند. همراه با محتوای واقعی، مانند آدرس و شماره تلفن، پاسخ همچنین می‌تواند حاوی محتوایی باشد که کاربران در Google Maps ارائه کرده‌اند، مانند نظرات و عکس‌ها. علاوه بر این، هنگامی که از قابلیت‌های مدل Gemini برای Places API (جدید) استفاده می‌کنید، پاسخ می‌تواند شامل داده‌های تولیدی باشد که از یک LLM جمع‌آوری و خلاصه می‌شوند.

اگرچه Google یک سری اقدامات را برای شناسایی محتوای مشکل دار قبل از بازگرداندن آن توسط Places API (جدید) انجام داده است، ما همچنین راهی را برای کاربران ارائه می دهیم که محتوای نامناسب را پرچم گذاری کنند تا Google بتواند آن را حذف کند. با این نسخه، Places API (جدید) شامل فیلد flagContentUri جدید در همه بررسی‌ها، عکس‌ها و خلاصه‌های تولیدی موجود در پاسخ Places API (جدید) می‌شود. این فیلد حاوی یک پیوند، شامل یک شناسه محتوای منحصربه‌فرد است که به کاربران امکان می‌دهد Google را از محتوای نامناسب مطلع کنند.

به عنوان مثال، شما درخواستی را ارائه می کنید که برای یک مکان، پنج بررسی جداگانه را برمی گرداند. هر مرور فردی شامل فیلد flagContentUri جدید با یک شناسه منحصربه‌فرد برای آن بررسی است تا کاربر بتواند مشکلی را در مورد هر یک یا همه نظرات گزارش کند.

API Explorer به شما امکان می دهد درخواست های زنده بنویسید تا بتوانید با این گزینه های جدید آشنا شوید:

آن را امتحان کنید!

URL موجود در قسمت flagContentUri شامل یک شناسه منحصر به فرد برای محتوا است. با مرور این پیوند، یک صفحه وب میزبانی شده توسط Google به شکل زیر باز می شود:

گزارش یک وب مشکل صفحه

از این گفتگو، کاربران شما می توانند گزارشی را برای نوع مشکل مناسب با Google ارسال کنند. به عنوان مثال، آنها می توانند توهین، قلدری، یا یک مشکل قانونی را در مورد محتوا گزارش کنند.

نمایش لینک گزارش محتوا

فیلد flagContentUri در اشیاء زیر موجود است که قبلاً بخشی از پاسخ Places API (جدید) هستند:

هنگام نمایش این اشیاء باید پیوند گزارش محتوا را نمایش دهید تا مشتریان شما بتوانند هرگونه مشکل محتوا را گزارش کنند.

به لینک گزارش محتوا در پاسخ دسترسی پیدا کنید

درخواست جزئیات مکان (جدید) شامل بررسی مکان در پاسخ است:

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

پاسخ به این شکل است:

{
  "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 حاوی فیلد flagContentUri ، از جمله یک شناسه منحصر به فرد برای آن بررسی خاص است. مرور به آن پیوند به مشتریان شما امکان می دهد محتوای نامناسب را برای آن بررسی خاص گزارش کنند.

اگر 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

پاسخ همچنین شامل آرایه photos است که در آن هر عنصر حاوی فیلد 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"
    },
    ...
  ]

پیوندهای محتوا تا زمانی که محتوای پشتیبان حذف نشود فعال می مانند. پیوندها همچنان به باز کردن گفتگو برای محتوای حذف شده ادامه می دهند، اما ثبت گزارش در مورد محتوایی که قبلاً حذف شده است تأثیری ندارد.

آن را امتحان کنید!

API Explorer به شما امکان می دهد درخواست های نمونه بنویسید تا بتوانید با API و گزینه های API آشنا شوید.

  1. نماد API را انتخاب کنید، API Explorer را گسترش دهید. ، در سمت راست صفحه.

  2. به صورت اختیاری نمایش پارامترهای استاندارد را گسترش دهید و پارامتر fields را روی فیلد ماسک تنظیم کنید.

  3. به صورت اختیاری بدنه درخواست را ویرایش کنید.

  4. دکمه Execute را انتخاب کنید. در گفتگو، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.

  5. در پانل API Explorer، نماد گسترش را انتخاب کنید، API Explorer را گسترش دهید. ، برای گسترش پنجره API Explorer.