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

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

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

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

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

למידע נוסף על תחילת העבודה עם ממשקי Business Profile API, קראו את המאמר הגדרה בסיסית.

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

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

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

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

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

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

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

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.