الإبلاغ عن محتوى غير ملائم

تعرض Places API معلومات عن مكان معيّن في الردّ. بالإضافة إلى المحتوى الذي يستند إلى الحقائق، مثل العنوان ورقم الهاتف، يمكن أن يحتوي الردّ أيضًا على محتوى ساهم به المستخدمون على "خرائط Google"، مثل المراجعات والصور. بالإضافة إلى ذلك، عند استخدام إمكانات نموذج Gemini لواجهة برمجة التطبيقات Places API، يمكن أن يتضمّن الردّ بيانات توليدية مجمّعة وملخّصة من نموذج لغوي كبير.

على الرغم من أنّ Google قد نفّذت سلسلة من الإجراءات لتحديد المحتوى الذي يمثّل مشكلة قبل أن تعرضه Places API، نوفّر أيضًا طريقة ليقوم المستخدمون بالإبلاغ عن المحتوى غير الملائم كي تتمكّن Google من إزالته. في هذا الإصدار، تتضمّن Places API حقل flagContentUri الجديد في كل المراجعات والصور والملخّصات التوليدية المضمّنة في ردّ flagContentUri. يحتوي هذا الحقل على رابط، بما في ذلك معرّف محتوى فريد، يتيح للمستخدمين إبلاغ Google بالمحتوى غير الملائم.

على سبيل المثال، قد تقدّم طلبًا يعرض خمس مراجعات فردية لمكان معيّن. يتضمّن كل مراجعة فردية حقل flagContentUri الجديد مع معرّف فريد لتلك المراجعة حتى يتمكّن المستخدم من الإبلاغ عن مشكلة في أي مراجعة أو في كل المراجعات.

يتيح لك "مستكشف واجهة برمجة التطبيقات" تقديم طلبات مباشرة حتى تتمكّن من التعرّف على هذه الخيارات الجديدة:

جرِّبه الآن

يحتوي عنوان URL الوارد في الحقل flagContentUri على معرّف فريد ل المحتوى. يؤدي الانتقال إلى هذا الرابط إلى فتح صفحة ويب مستضافة على Google بالشكل التالي:

صفحة الويب للإبلاغ عن مشكلة

من مربّع الحوار هذا، يمكن للمستخدمين إرسال بلاغ إلى Google بشأن نوع المشكلة المناسب. على سبيل المثال، يمكنهم الإبلاغ عن محتوى يتضمّن لغة نابية أو سلوكًا تنمريًا أو مشكلة قانونية.

الأسعار

هذه الميزة في مرحلة معاينة الإصدار العلني، ولا يتم تحصيل أي رسوم، ما يعني أنّه لن يتم تحصيل أي رسوم مقابل استخدامها خلال مرحلة المعاينة. للحصول على تفاصيل حول الأسعار المقترَحة، يُرجى الاطّلاع على Places API Usage and Billing.

عرض رابط الإبلاغ عن المحتوى

يضيف إصدار المعاينة هذا الحقل الجديد flagContentUri إلى العناصر التالية التي تشكّل جزءًا من استجابة Places API:

  • Review
  • Photo

  • GenerativeSummary تتوفّر حقلَان جديدان في GenerativeSummary فقط:

    • overviewFlagContentUri: الرابط لإشعار Google بالمحتوى غير الملائم في النظرة العامة
    • descriptionFlagContentUri: الرابط لإعلام Google بالمحتوى غير الملائم في الوصف

  • AreaSummary

  • ContextualContent

خلال فترة المعاينة، ليس عليك عرض رابط الإبلاغ عن المحتوى عند عرض هذه العناصر لعملائك.

ومع ذلك، عندما يتم نقل هذه الميزة إلى معلومات التوفّر للجمهور العام، عليك عرض رابط "الإبلاغ عن المحتوى" عند عرض هذه العناصر حتى يتمكّن عملاؤك من الإبلاغ عن أي مشاكل في المحتوى.

الوصول إلى رابط الإبلاغ عن المحتوى في الردّ

يتضمّن طلب تفاصيل الأماكن التالي مراجعات الأماكن في الاستجابة:

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

تظل روابط المحتوى مفعّلة إلى أن تتم إزالة المحتوى الأساسي. تستمر الروابط في فتح مربّع الحوار للمحتوى الذي تمت إزالته، ولكن لن يكون لإعداد بلاغ بشأن محتوى تمت إزالته من قبل أي تأثير.

جرّب الآن

يتيح لك "مستكشف واجهات برمجة التطبيقات" تقديم طلبات نموذجية حتى تتمكّن من التعرّف على خيارات واجهة برمجة التطبيقات وواجهة برمجة التطبيقات.

  1. انقر على رمز واجهة برمجة التطبيقات وسِّع "مستكشف واجهات برمجة التطبيقات". على يمين الصفحة.

  2. يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبط المَعلمة fields على قناع الحقل.

  3. يمكنك اختياريًا تعديل نص الطلب.

  4. انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.

  5. في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع وسِّع "مستكشف واجهات برمجة التطبيقات". لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".