Method: accounts.locations.batchGetReviews

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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)

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