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

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

على الرغم من أنّ 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"
    },
    ...
  ]

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

جرّب الآن

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

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

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

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

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

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