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)

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