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

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

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

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

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

امتحان کنید!

قالب پیوند

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

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

نمایش پیوند گزارش تخلف محتوا

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

• Review
• Photo
• GenerativeSummary
• NeighborhoodSummary
• EvChargeAmenitySummary
• ReviewSummary
• ContextualContent

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

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

توجه: برای نمونه‌های استفاده از GenerativeSummary،‏ NeighborhoodSummary، EvChargeAmenitySummary، و ReviewSummary، به قابلیت‌های مدل Gemini برای 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. نماد میانای برنامه‌سازی کاربردی () را در سمت راست صفحه انتخاب کنید.

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

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

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

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