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

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

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

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

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

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

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

החזרת תשובות

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

  • מחזיר את כל ההגדרות של הלקוח. הלקוח הוא אחד מהלקוחות הקיימים שלכם. באמצעות ה-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: קוד מדינה לפי תקן ISO של הלקוח, שהוא בן 2 תווים.
  • 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"
}