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

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 ارسال کنند. به عنوان مثال، آنها می توانند توهین، قلدری، یا یک مشکل قانونی را در مورد محتوا گزارش کنند.

قیمت گذاری

این ویژگی در مرحله پیش‌نمایش پیش‌نمایش GA است و هزینه‌ای دریافت نمی‌کند، به این معنی که صورت‌حساب 0 دلار برای استفاده در حین پیش‌نمایش است. برای جزئیات در مورد قیمت پیشنهادی، استفاده و صورتحساب Places API را ببینید.

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

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

  • Review
  • Photo

  • GenerativeSummary فقط برای GenerativeSummary ، دو فیلد جدید وجود دارد:

    • overviewFlagContentUri : پیوندی که در نمای کلی به Google از محتوای نامناسب اطلاع می‌دهد.
    • descriptionFlagContentUri : پیوندی برای اطلاع دادن به Google از محتوای نامناسب در توضیحات.

  • AreaSummary

  • ContextualContent

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

با این حال، وقتی این ویژگی به دسترسی عمومی (GA) می‌رود، باید پیوند گزارش محتوا را هنگام نمایش این اشیاء نمایش دهید تا مشتریان شما بتوانند هرگونه مشکل محتوا را گزارش کنند.

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

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

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.