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

כדי לאחזר ולעדכן את פרטי הלקוח באמצעות 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. יוצרים מינוי לחשבון הלקוח החדש.

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

אי אפשר לעדכן את customerType באמצעות Reseller API, אבל אפשר לאמת את הדומיין של לקוח 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 מחזירה קוד סטטוס HTTP 200 ואת הגדרות הלקוח המעודכנות:

{
  "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"
}