Method: accounts.listRecommendGoogleLocations

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

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

בקשת 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.