تعرض Places API (الإصدار الجديد) معلومات عن مكان في ردّ. بالإضافة إلى المحتوى الواقعي، مثل العنوان ورقم الهاتف، يمكن أن يحتوي الردّ أيضًا على محتوى ساهم به المستخدمون على "خرائط Google"، مثل المراجعات والصور. بالإضافة إلى ذلك، عند استخدام إمكانات نموذج Gemini لواجهة برمجة التطبيقات Places API (الإصدار الجديد)، يمكن أن يتضمّن الردّ بيانات توليدية مجمّعة وملخّصة من نموذج لغوي كبير.
على الرغم من أنّ Google قد نفّذت سلسلة من الإجراءات لتحديد المحتوى المثير للقلق
قبل أن تعرضه Places API (الإصدار الجديد)، نوفّر أيضًا
طريقة للمستخدمين للإبلاغ عن المحتوى غير الملائم كي تتمكّن Google من إزالته. في
هذا الإصدار، تتضمّن Places API (الإصدار الجديد) الحقل الجديد flagContentUri
في جميع المراجعات والصور والملخّصات التوليدية المضمّنة في ردّ
Places API (الإصدار الجديد). يحتوي هذا الحقل على رابط يتضمّن معرّفًا فريدًا
للمحتوى، ما يتيح للمستخدمين إبلاغ Google بالمحتوى غير الملائم.
على سبيل المثال، قد تقدّم طلبًا يعرض خمس مراجعات فردية لمكان معيّن. يتضمّن كل مراجعة فردية حقل flagContentUri
الجديد الذي يحتوي على معرّف فريد لهذه المراجعة حتى يتمكّن المستخدم من الإبلاغ عن مشكلة في أي من المراجعات أو
كلها.
يتيح لك "مستكشف واجهة برمجة التطبيقات" تقديم طلبات مباشرة حتى تتمكّن من التعرّف على هذه الخيارات الجديدة:
تنسيق الرابط
يحتوي عنوان URL الوارد في الحقل flagContentUri
على معرّف فريد ل
المحتوى. يؤدي الانتقال إلى هذا الرابط إلى فتح صفحة ويب مستضافة على Google بالشكل التالي:
من مربّع الحوار هذا، يمكن للمستخدمين إرسال بلاغ إلى Google بشأن نوع المشكلة المناسب. على سبيل المثال، يمكنهم الإبلاغ عن محتوى يتضمّن لغة نابية أو تنمرًا أو مشكلة قانونية.
عرض رابط الإبلاغ عن المحتوى
يتوفّر الحقل flagContentUri
في العناصر التالية التي كانت
سابقًا جزءًا من ردّ Places API (الإصدار الجديد):
Review
Photo
GenerativeSummary
NeighborhoodSummary
EvChargeAmenitySummary
ReviewSummary
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
على قناع الحقل.يمكنك اختياريًا تعديل نص الطلب.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع
لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".