Method: accounts.locations.batchGetReviews

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

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

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

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

पाथ पैरामीटर

पैरामीटर
name

string

उस खाते का नाम जिससे कई जगहों की समीक्षाओं की सूची वापस लानी है.

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
फ़ील्ड
locationNames[]

string

समीक्षाएं पाने के लिए जगहों का कलेक्शन. इन्हें इनके नामों से तय किया जाता है.
pageSize

integer

हर पेज पर कितनी समीक्षाएं फ़ेच करनी हैं. डिफ़ॉल्ट वैल्यू 50 होती है.
pageToken

string

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

string

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

boolean

सिर्फ़ रेटिंग वाली समीक्षाओं को अनदेखा करना है या नहीं.

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

Reviews.BatchGetReviews के लिए जवाब का मैसेज.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
locationReviews[]

object (LocationReview)

जगह की जानकारी वाली समीक्षाएं.
nextPageToken

string

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

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

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

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

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

LocationReview

इसमें जगह की जानकारी के साथ समीक्षा दिखाई जाती है.

JSON के काेड में दिखाना 
{
  "name": string,
  "review": {
    object (Review)
  }
}
फ़ील्ड
name

string

जगह के संसाधन का नाम.
review

object (Review)

जगह की समीक्षा.