Method: accounts.listRecommendGoogleLocations

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

ההמלצות לחשבונות אישיים מבוססות על כל המיקומים שלמשתמש יש גישה אליהם בפרופיל העסק (כולל מיקומים שניתן לגשת אליהם דרך קבוצות לפי מיקום), והן קבוצת-על של כל ההמלצות שנוצרו עבור המשתמש.

בקשת HTTP

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
name

string

השם של משאב החשבון שעבורו יש לאחזר את המיקומים המומלצים של Google.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

כמה מיקומים לאחזר בכל דף. ברירת המחדל היא 25, המינימום הוא 1 וגודל הדף המקסימלי הוא 100.
pageToken

string

אם צוין, דף המיקומים הבא מאוחזר.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

הודעת תגובה עבור GoogleLocations.ListRecommendedGoogleLocations.

הוא מכיל גם מיקומים מסוימים שמשתמשים אחרים ב'פרופיל העסק ב-Google' תבעו עליהם בעלות מאז הפעם האחרונה שהם הומלצו לחשבון הזה ב'פרופיל העסק ב-Google'.

ייצוג JSON 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
שדות
googleLocations[]

object (GoogleLocation)

המיקומים המומלצים לחשבון ב'פרופיל העסק ב-Google'. כל אחד מהערכים האלה מייצג GoogleLocation שנמצא במפות Google. המיקומים ממוינים לפי סדר הרלוונטיות שלהם לחשבון ב'פרופיל העסק ב-Google'.
totalSize

integer

המספר הכולל של מיקומים מומלצים לחשבון 'פרופיל העסק ב-Google', ללא קשר לחלוקה לדפים.
nextPageToken

string

במהלך העימוד, אם יש מיקומים נוספים הזמינים לאחזור בדף הבא, השדה הזה יאוכלס באסימון לאחזור דף המיקומים הבא בקריאה הבאה. אם אין עוד מיקומים לאחזור, השדה הזה לא יופיע בתגובה.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.