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

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

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

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

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

امتحانش کن!

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

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

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

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

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

اگر 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. در صورت تمایل، Show standard parameters را گسترش داده و پارامتر fields را روی field mask تنظیم کنید.

  3. به صورت اختیاری، متن درخواست (Request body) را ویرایش کنید.

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

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