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

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

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

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

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

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

צריך להחליף את CUSTOMER_ID במאפיין הייחודי של הלקוח או שם דומיין.

החזרת תגובה

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

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

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

באמצעות ממשק ה-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: בן 2 תווים של הלקוח קוד מדינה לפי תקן ISO.
  • EMAIL_ADDRESS: כתובת האימייל של הלקוח שלכם – עבור לדוגמה, cruz@example.com.

תגובת 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"
}