تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

جرِّبه الآن

تنسيق الرابط

يتضمّن عنوان 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"
    },
    ...
  ]

انتهاء صلاحية الرابط

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

جرِّبها الآن.

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

انقر على رمز واجهة برمجة التطبيقات على يسار الصفحة.
يمكنك توسيع عرض المَعلمات العادية وضبط مَعلمة fields على قناع الحقل.
يمكنك تعديل نص الطلب اختياريًا.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".