רשימה של כל החשבונות של המשתמש המאומת. זה כולל את כל החשבונות שבבעלות המשתמש, וכן חשבונות שבהם יש למשתמש זכויות ניהול.
בקשת HTTP
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
parentAccount |
אפשרות. שם המשאב של החשבון שעבורו יש לאחזר את רשימת החשבונות הנגישים באופן ישיר. הדבר הגיוני רק לארגונים ולקבוצות משתמשים. אם השדה יישאר ריק, הפונקציה מחזירה את הערך |
pageSize |
אפשרות. כמה חשבונות לאחזר בכל דף. ערך ברירת המחדל והערך המקסימלי הוא 20. |
pageToken |
אפשרות. אם צוין, הדף הבא של החשבונות יאוחזר. הערך |
filter |
אפשרות. מסנן שמגביל את החזרה של החשבונות. התשובה תכלול רק ערכים שתואמים למסנן. אם השדה לדוגמה, בקשה עם המסנן השדה |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
הודעת תגובה עבור Accounts.ListAccounts.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"accounts": [
{
object ( |
שדות | |
---|---|
accounts[] |
אוסף של חשבונות שאליהם למשתמש יש גישה. החשבון האישי של המשתמש שמבצע את השאילתה יהיה תמיד הפריט הראשון של התוצאה, אלא אם יתבצע סינון. |
nextPageToken |
אם מספר החשבונות חורג מגודל הדף המבוקש, השדה הזה יאוכלס באסימון שיאפשר אחזור של דף החשבונות הבא בקריאה הבאה אל |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/business.manage
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.