Method: accounts.locations.reviews.list

किसी खास जगह के लिए, पेजों वाली समीक्षाओं की सूची दिखाता है. यह कार्रवाई सिर्फ़ तभी मान्य होगी, जब बताई गई जगह की पुष्टि हो चुकी हो.

एचटीटीपी अनुरोध

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

उस जगह का नाम जिसके लिए समीक्षाएं फ़ेच करनी हैं.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

हर पेज पर कितनी समीक्षाएं फ़ेच करनी हैं. ज़्यादा से ज़्यादा pageSize 50 हो सकते हैं.
pageToken

string

अगर बताया गया है, तो यह समीक्षाओं का अगला पेज फ़ेच करता है.
orderBy

string

समीक्षाओं को क्रम से लगाने के लिए, फ़ील्ड के बारे में बताता है. अगर इसकी जानकारी नहीं दी जाती है, तो वापस की गई समीक्षाओं का क्रम डिफ़ॉल्ट रूप से updateTime desc पर सेट हो जाएगा. इसके हिसाब से क्रम में लगाने के लिए मान्य ऑर्डर rating, rating desc, और updateTime desc हैं.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

Reviews.Listसमीक्षाएं के लिए जवाब देने वाला मैसेज.

JSON के काेड में दिखाना 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
फ़ील्ड
reviews[]

object (Review)

समीक्षाएं.
averageRating

number

इस जगह के लिए सभी समीक्षाओं की औसत स्टार रेटिंग 1 से 5 के पैमाने पर होती है, जिसमें 5 सबसे ज़्यादा रेटिंग है.
totalReviewCount

integer

इस जगह के लिए समीक्षाओं की कुल संख्या.
nextPageToken

string

अगर समीक्षाओं की संख्या, अनुरोध किए गए पेज साइज़ से ज़्यादा हो जाती है, तो इस फ़ील्ड में एक टोकन मौजूद होता है. इसकी मदद से, reviews.list के बाद आने वाले कॉल पर समीक्षाओं का अगला पेज फ़ेच किया जा सकता है. अगर और समीक्षाएं नहीं हैं, तो जवाब में यह फ़ील्ड मौजूद नहीं होता.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.