تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

جرِّبه الآن

تنسيق الرابط

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

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

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

التسعير

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

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

يضيف إصدار المعاينة هذا الحقل الجديد 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"
    },
    ...
  ]

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

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

جرّب الآن

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

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