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

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

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

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

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

במאמר הגדרה בסיסית מוסבר איך מתחילים להשתמש בממשקי ה-API של פרופיל העסק ב-Google.

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

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

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

HTTP

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

החזרת חשבון ספציפי

לפעמים רוצים לראות מידע רק על חשבון ספציפי של משתמש מאומת. שימוש ב-accounts.get API כדי להחזיר חשבון ספציפי ולבדוק פרטים נוספים לגבי החשבון.

כדי להחזיר חשבון ספציפי לפי שם, צריך להשתמש באפשרויות הבאות:

HTTP

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

עדכון חשבון

שינוי שם של חשבון הוא משימה ניהולית בסיסית. שינוי שם החשבון באמצעות ה-API accounts.update.

כדי לעדכן חשבון ספציפי לפי שם, משתמשים בהוראות הבאות:

HTTP

$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

הגבלות

• השדה היחיד שניתן לעריכה בחשבון הוא accountName. המערכת תתעלם משדות אחרים שהועברו.
• ניתן לעדכן באופן הזה רק חשבונות מסוג BUSINESS.