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

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

على الرغم من أنّ Google قد نفّذت سلسلة من الإجراءات لتحديد المحتوى الذي يمثّل مشكلة قبل أن تعرضه Places API، نوفّر أيضًا طريقة ليقوم المستخدمون بالإبلاغ عن المحتوى غير الملائم كي تتمكّن Google من إزالته. في هذا الإصدار، تتضمّن Places API حقل flagContentUri الجديد في كل المراجعات والصور والملخّصات التوليدية المضمّنة في ردّ flagContentUri. يحتوي هذا الحقل على رابط، بما في ذلك معرّف محتوى فريد، يتيح للمستخدمين إبلاغ 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"
    },
    ...
  ]

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

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

جرّب الآن

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

1. انقر على رمز واجهة برمجة التطبيقات على يمين الصفحة.

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

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

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

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