עבודה עם נתוני חשבון

במדריך הזה מוסבר איך לעבוד עם נתוני החשבון. My Business Account Management API מאפשר לך לבצע את הפעולות הבאות:

• הצגת רשימה של כל החשבונות.
• החזרת חשבון ספציפי.
• עדכון חשבון.

לפני שמתחילים

לפני שמשתמשים ב-My Business Account Management API, צריך לרשום את הבקשה ולקבל פרטי כניסה של OAuth 2.0.

לקבלת פרטים על תחילת העבודה עם ממשקי ה-API של 'פרופיל העסק ב-Google', אפשר לעיין במאמר בנושא הגדרה בסיסית.

הצגת רשימה של כל החשבונות

דרך מצוינת לאמת את החשבונות המשויכים למשתמש מאומת היא לרשום את כל החשבונות שלהם. שימוש בaccounts.list ממשק API להצגת כל החשבונות שמשויכים למשתמש.

כדי להציג את כל החשבונות של משתמשים מאומתים, משתמשים בפרטים הבאים:

$ 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.