אחזור & עדכון פרטי חשבון של לקוח

כדי לאחזר ולעדכן את פרטי הלקוח באמצעות Reseller API, יש שתי דרכים לחפש את הלקוח:

• המזהה הייחודי של הלקוח – לדוגמה, C0123456
• שם הדומיין של הלקוח – לדוגמה, example.com

אחזור פרטי החשבון של לקוח

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

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

מחליפים את CUSTOMER_ID בשם הדומיין או במזהה הייחודי של הלקוח.

החזרות של תשובות

כשאתם מאחזרים את פרטי החשבון של לקוח, יכול להיות שתקבלו אחת מהתשובות הבאות:

• החזרת ההגדרות המלאות של הלקוח. הלקוח הוא אחד מהלקוחות הקיימים שלכם. באמצעות Reseller API תוכלו לנהל את החשבון ואת הגדרות המינוי של הלקוח הזה.

• החזרת פרטי החשבון המינימליים של הלקוח אם התשובה מחזירה רק את השדות customerId, ‏ customerDomain ו-customerType, הלקוח מנוהל על ידי Google או על ידי מפיץ אחר. לא ניתן ליצור לקוח נוסף של הלקוח הזה שבו האימות מתבצע באמצעות אימייל. כדי לנהל את הלקוח הזה:

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

• החזרת הערך Multiple teams exist on this domain. לדומיין הזה משויך לקוח צוות אחד או יותר. כדי להוסיף צוות נוסף לדומיין הזה:

  1. הזמנת חשבון לקוח
  2. כדי ליצור לקוח מאומת לפי דומיין, צריך לבקש מהלקוח לרכוש מינוי ישיר דרך Google ולאמת את הדומיין שלו, להשתלט על צוותים קיימים ואז להעביר את המינוי לחשבון שלכם.

• היא מחזירה שגיאת HTTP‏ 404. הלקוח חדש ב-Google ואין לו חשבון. כדי לנהל את הלקוח הזה, מבצעים את השלבים הבאים:

  1. מוודאים שרשומות הלקוחות לא מכילות נתוני לקוחות ישנים עם אי-התאמה פוטנציאלית בין שם הדומיין הראשי של הלקוח לבין מזהה הלקוח הייחודי ב-Google. כשחשבון Google שנמחק בעבר מוחזר, הוא מטופל כחשבון חדש ויש לו ערך customerId חדש, גם אם החשבון שומר על אותו ערך customerDomain.
  2. הזמנת חשבון לקוח חדש
  3. יוצרים מינוי לחשבון הלקוח החדש.

עדכון ההגדרות של לקוח

באמצעות Reseller API אי אפשר לעדכן את customerType, אבל אפשר לאמת את הדומיין של לקוח team ולהפוך ללקוח domain.

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

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

גוף הבקשה בפורמט JSON מעדכן את הגדרות הלקוח הבאות:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

מחליפים את מה שכתוב בשדות הבאים:

• DOMAIN_NAME: הדומיין של הלקוח – לדוגמה, example.com
• NAME: שם הלקוח – לדוגמה, Alex Cruz.
• ORGANIZATION_NAME: שם הארגון של הלקוח – לדוגמה, Example Organization.
• POSTAL_CODE: המיקוד של הלקוח, לדוגמה 94043.
• COUNTRY_CODE: קוד המדינה בתקן ISO בן 2 התווים של הלקוח.
• EMAIL_ADDRESS: כתובת האימייל של הלקוח, לדוגמה [e-mail].

תגובה מוצלחת בפורמט JSON מחזירה את קוד הסטטוס 200 של HTTP ואת הגדרות הלקוח המעודכנות:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}