Method: projects.locations.endpoints.queryAccount

הוצא משימוש: צריך להשתמש בשיטה endpoints.queryData במקום זאת. שליפת כל המידע שמאוחסן על חשבון ברשת. פרטי החשבון שמוחזרים עשויים להשתנות בין קריאות, כי נקודת קצה עשויה לנתב בקשות למאמתים שונים בתוך הרשת והאזור, ויכול להיות שהמאמתים לא יהיו באותו מזהה סבב בכל זמן נתון.

בקשת HTTP


GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount

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

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

פרמטרים
endpoint

string

חובה. נקודת הקצה (endpoint) שממלאת את הבקשה. פורמט: projects/{project}/locations/{location}/endpoints/{endpoint} המיקום הוא אזור.

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

פרמטרים
accountId

string

חובה. מזהה החשבון שרוצים לקבל מידע לגביו. הערך מוגבל ל-60 תווים.
roundId

string (int64 format)

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

גוף הבקשה

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

גוף התשובה

הודעת תגובה ל-endpoints.queryAccount.

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

ייצוג ב-JSON 
{
  "account": {
    object (Account)
  }
}
שדות
account

object (Account)

פרטי החשבון, יחד עם הגובה שבו הוא התקבל.

היקפי הרשאות

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

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב endpoint:

  • universalledger.endpoints.readNetwork

מידע נוסף זמין במאמרי העזרה בנושא IAM.