Places API, जवाब के तौर पर किसी जगह की जानकारी दिखाता है. जवाब में, पते और फ़ोन नंबर जैसे तथ्यों के साथ-साथ, Google Maps पर लोगों की ओर से जोड़े गए कॉन्टेंट को भी शामिल किया जा सकता है. जैसे, समीक्षाएं और फ़ोटो. इसके अलावा, Places API के लिए Gemini मॉडल की सुविधाओं का इस्तेमाल करने पर, जवाब में जनरेटिव डेटा शामिल हो सकता है. यह डेटा, एलएलएम से इकट्ठा और इकट्ठा किया गया होता है.
Google ने Places API से समस्या वाले कॉन्टेंट को दिखाने से पहले, उसकी पहचान करने के लिए कई तरीके लागू किए हैं. हालांकि, हम उपयोगकर्ताओं को आपत्तिजनक कॉन्टेंट को फ़्लैग करने का विकल्प भी देते हैं, ताकि Google उसे हटा सके. इस रिलीज़ के बाद, Places API के जवाब में शामिल सभी समीक्षाओं, फ़ोटो, और जनरेटिव समरी में नया flagContentUri
फ़ील्ड शामिल होगा. इस फ़ील्ड में एक लिंक होता है. इसमें कॉन्टेंट का यूनीक आइडेंटिफ़ायर भी शामिल होता है. इसकी मदद से, उपयोगकर्ता Google को आपत्तिजनक कॉन्टेंट की शिकायत कर सकते हैं.
उदाहरण के लिए, आपने किसी जगह के लिए पांच अलग-अलग समीक्षाएं पाने का अनुरोध किया है. हर समीक्षा में, उस समीक्षा के लिए यूनीक आइडेंटिफ़ायर वाला नया flagContentUri
फ़ील्ड शामिल होता है, ताकि कोई उपयोगकर्ता किसी भी या सभी समीक्षाओं से जुड़ी समस्या की शिकायत कर सके.
API एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं, ताकि आप इन नए विकल्पों के बारे में जान सकें:
लिंक का फ़ॉर्मैट
flagContentUri
फ़ील्ड में मौजूद यूआरएल में, कॉन्टेंट के लिए एक यूनीक आइडेंटिफ़ायर शामिल होता है. इस लिंक पर ब्राउज़ करने से, Google की ओर से होस्ट किया गया वेब पेज इस फ़ॉर्म में खुलता है:
इस डायलॉग बॉक्स की मदद से, आपके उपयोगकर्ता सही तरह की समस्या के लिए Google को शिकायत कर सकते हैं. उदाहरण के लिए, वे अपशब्दों, धमकी देने या कॉन्टेंट से जुड़ी किसी कानूनी समस्या की शिकायत कर सकते हैं.
कीमत
यह सुविधा, GA के रिलीज़ होने से पहले की झलक के तौर पर उपलब्ध है. इसका इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. इसका मतलब है कि झलक के दौरान इस्तेमाल करने पर, बिलिंग 0 डॉलर होगी. तय की गई कीमत के बारे में ज़्यादा जानने के लिए, Places API के इस्तेमाल और बिलिंग देखें.
कॉन्टेंट की शिकायत करने का लिंक दिखाना
झलक वाली इस रिलीज़ में, इन ऑब्जेक्ट में नया flagContentUri
फ़ील्ड जोड़ा गया है. ये ऑब्जेक्ट पहले से ही Places API के रिस्पॉन्स का हिस्सा हैं:
Review
Photo
GenerativeSummary
सिर्फ़GenerativeSummary
के लिए, दो नए फ़ील्ड हैं:overviewFlagContentUri
: खास जानकारी में मौजूद आपत्तिजनक कॉन्टेंट के बारे में Google को सूचना देने के लिए लिंक.descriptionFlagContentUri
: ब्यौरे में मौजूद आपत्तिजनक कॉन्टेंट के बारे में Google को सूचना देने के लिए लिंक.
झलक दिखाने की अवधि के दौरान, यह ज़रूरी नहीं है कि आप अपने ग्राहकों को ये ऑब्जेक्ट दिखाते समय, कॉन्टेंट की शिकायत करने का लिंक दिखाएं.
हालांकि, जब यह सुविधा सभी के लिए उपलब्ध हो जाएगी, तो आपको इन ऑब्जेक्ट को दिखाते समय, कॉन्टेंट की शिकायत करने का लिंक दिखाना होगा, ताकि आपके ग्राहक कॉन्टेंट से जुड़ी किसी भी समस्या की शिकायत कर सकें.
जवाब में, कॉन्टेंट की शिकायत करने के लिए दिया गया लिंक ऐक्सेस करना
जगह की जानकारी के लिए किए गए इस अनुरोध के जवाब में, जगह की समीक्षाएं शामिल हैं:
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
पैरामीटर को फ़ील्ड मास्क पर सेट करें.अनुरोध के मुख्य हिस्से में बदलाव करें. हालांकि, ऐसा करना ज़रूरी नहीं है.
लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन चुनें.