Method: accounts.locations.batchGetReviews

מחזירה רשימה מעומדת של ביקורות לכל המיקומים שצוינו. פעולה זו תקפה רק אם המיקומים שצוינו מאומתים.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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

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.

LocationReview

מייצג ביקורת עם פרטי מיקום.

ייצוג JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
שדות
name

string

שם של משאב מיקום.
review

object (Review)

ביקורת על המיקום.