تعرض 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 (الجديدة):
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
على قناع الحقل.يمكنك اختياريًا تعديل نص الطلب.
انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.
في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع
لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".