מחזירה רשימה מעומדת של ביקורות לכל המיקומים שצוינו. פעולה זו תקפה רק אם המיקומים שצוינו מאומתים.
בקשת HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
name |
שם החשבון שממנו ניתן לאחזר רשימת ביקורות בכמה מיקומים. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON | |
---|---|
{ "locationNames": [ string ], "pageSize": integer, "pageToken": string, "orderBy": string, "ignoreRatingOnlyReviews": boolean } |
שדות | |
---|---|
locationNames[] |
אוסף של מיקומים שעבורם יש לאחזר ביקורות, מצוינים לפי השמות שלהם. |
pageSize |
כמה ביקורות להביא לכל דף. ערך ברירת המחדל הוא 50. |
pageToken |
אם צוין, הוא מאחזר את דף הביקורות הבא. |
orderBy |
אפשרות. מציין את השדה שלפיו רוצים למיין את הביקורות. אם לא צוין, סדר הביקורות שיוחזר יוגדר כברירת מחדל ל- |
ignoreRatingOnlyReviews |
האם להתעלם מביקורות עם דירוג בלבד. |
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
הודעת תגובה ל-Reviews.BatchGetReviews.
ייצוג JSON | |
---|---|
{
"locationReviews": [
{
object ( |
שדות | |
---|---|
locationReviews[] |
ביקורות עם פרטי מיקום. |
nextPageToken |
אם מספר הביקורות חורג מגודל הדף המבוקש, השדה הזה יאוכלס באסימון לאחזור דף הביקורות הבא בקריאות הבאות. אם אין ביקורות נוספות, השדה הזה לא יופיע בתשובה. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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 ( |
שדות | |
---|---|
name |
שם של משאב מיקום. |
review |
ביקורת על המיקום. |