שליחת שאילתה לגבי כל המידע שמאוחסן על חשבון ברשת. פרטי החשבון שמוחזרים עשויים להיות שונים בין קריאות, כי נקודת קצה עשויה לנתב בקשות למאמתים שונים ברשת ובאזור, והמאמתים לא בהכרח נמצאים באותו מזהה סבב בכל זמן נתון.
בקשת HTTP
GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount כתובות ה-URL כתובות בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
endpoint |
חובה. נקודת הקצה למילוי הבקשה. פורמט: |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
accountId |
חובה. מספר החשבון שרוצים לקבל עליו מידע. הערך מוגבל ל-60 תווים. |
roundId |
זה שינוי אופציונלי. המזהה של סבב ההפעלה (דומה ל'גובה' הבלוק) שבו רוצים לבקש נתונים. פרטי החשבון שיוחזרו יהיו מדויקים לגבי מצב העולם בסבב הביצוע הזה. אם לא מציינים את מספר הסיבוב, המערכת משתמשת בסיבוב האחרון שהושלם, כפי שהוא ידוע לכלי לאימות התצוגה. המצב במזהה סבב נתון תמיד עקבי וקנוני. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
הודעת תגובה לנקודות הקצה (endpoints) של queryAccount.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{
"account": {
object ( |
| שדות | |
|---|---|
account |
פרטי החשבון, כולל הגובה שבו התקבלו. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
ניתן למצוא מידע נוסף כאן: Authentication Overview.