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.ListReviews के लिए जवाब का मैसेज.

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

object (Review)

समीक्षाएं.

averageRating

number

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

totalReviewCount

integer

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

nextPageToken

string

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

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

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

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

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