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

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

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

  1. מוודאים שברשומות לא מופיעים נתונים ישנים של לקוחות עם אי התאמה בין שם הדומיין הראשי לבין מזהה הלקוח הייחודי ב-Google. כשמפעילים מחדש חשבון שנמחק, המערכת מתייחסת אליו כאל חשבון חדש עם customerId חדש.
  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"
}