במדריך הזה מוסבר איך לעבוד עם נתוני החשבון. ה-My Business Account Management API מאפשר לבצע את הפעולות הבאות:
- רשום את כל החשבונות.
- החזרת חשבון ספציפי.
- מעדכנים חשבון.
לפני שמתחילים
לפני שתוכלו להשתמש ב-My Business Account Management API, עליכם לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0.
במאמר הגדרה בסיסית מוסבר איך מתחילים להשתמש בממשקי ה-API של פרופיל העסק ב-Google.
הצגת רשימה של כל החשבונות
שיטה מצוינת לאמת את החשבונות שמשויכים למשתמש מאומת היא להציג את כל החשבונות שלהם. משתמשים ב-API accounts.list
כדי לרשום את כל החשבונות שמשויכים למשתמש.
כדי להציג רשימה של כל החשבונות של משתמש מאומת, משתמשים בפרטים הבאים:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
החזרת חשבון ספציפי
לפעמים רוצים לראות מידע רק על חשבון ספציפי של משתמש מאומת. שימוש ב-accounts.get
API כדי להחזיר חשבון ספציפי ולבדוק פרטים נוספים לגבי החשבון.
כדי להחזיר חשבון ספציפי לפי שם, צריך להשתמש באפשרויות הבאות:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
עדכון חשבון
שינוי שם של חשבון הוא משימה ניהולית בסיסית. שינוי שם החשבון באמצעות ה-API accounts.update
.
כדי לעדכן חשבון ספציפי לפי שם, משתמשים בהוראות הבאות:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
הגבלות
- השדה היחיד שניתן לעריכה בחשבון הוא
accountName
. המערכת תתעלם משדות אחרים שהועברו. - ניתן לעדכן באופן הזה רק חשבונות מסוג
BUSINESS
.