Method: accounts.list

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

בקשת HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

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

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

פרמטרים
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של חשבונות להחזרה. ייתכן שהשירות יחזיר פחות מהערך הזה. אם לא מצוין, יוחזרו עד 250 חשבונות. הערך המקסימלי הוא 500; ערכים מעל 500 מועתקים ל-500.
pageToken

string

זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של accounts.list. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-accounts.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.
filter

string

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

גוף הבקשה

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

גוף התשובה

הודעת התגובה של השיטה accounts.list.

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

ייצוג JSON 
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
שדות
accounts[]

object (Account)

החשבונות שתואמים לListAccountsRequest.
nextPageToken

string

אסימון, שניתן לשלוח בתור pageToken כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

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