הזמנת חשבון לקוח חדש

לפני שיוצרים חשבון לקוח חדש, כדאי להביא בחשבון את הנקודות הבאות:

יצירת חשבון לקוח

  1. כדי ליצור חשבון לקוח, משתמשים בבקשה POST הבאה ומצרפים את אסימון ההרשאה:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. בחשבון החדש של הלקוח, יוצרים משתמש. אם התשובה מחזירה קוד סטטוס HTTP 409 Conflict, ה-customerId כבר קיים. לפני שמירשם את חשבון הלקוח, צריך להעביר את המינויים של הלקוח.

  3. אם רלוונטי, משנים את שפת ברירת המחדל של הלקוח.

  4. מעלים את המשתמש לתפקיד סופר-אדמין. כשיוצרים את חשבון האדמין, אפשר ליצור סיסמה זמנית אקראית או לבקש מהלקוח לספק סיסמה.

  5. מודיעים ללקוח שהוא צריך להיכנס למסוף Admin ולחתום על הסכם Google Workspace דרך המפיץ כדי להפעיל את החשבון. אסור למפיצים לחתום על התנאים וההגבלות בשם הלקוח.

סוגי לקוחות

אפשר ליצור שני סוגים של לקוחות ב-Google Workspace:

  • לקוחות עם אימות דומיין. הלקוחות האלה צריכים Gmail והרשאת אדמין מלאה. כשיוצרים לקוח מהסוג הזה, צריך להגדיר את הערך של customerType כ-domain.
  • לקוחות שאומתו באמצעות אימייל. הלקוחות האלה לא הבעלים של הדומיין שלהם ולא מנהלים אותו. כשיוצרים לקוח מהסוג הזה, צריך להגדיר את השדה customerType לערך team. לקוחות מהסוג הזה יכולים לרכוש את המהדורות Essentials ו-Enterprise Essentials של Google Workspace.

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

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "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.

בתגובה מוצלחת מוחזר קוד סטטוס HTTP‏ 200 והפרטים של הלקוח החדש:

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

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

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

בתגובה מוצלחת מוחזר קוד סטטוס HTTP‏ 200 והפרטים של הלקוח החדש:

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

שינוי שפת ברירת המחדל של לקוח

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

השפה שמוגדרת כברירת מחדל ללקוח חדש היא אנגלית. כדי לשנות את שפת ברירת המחדל, משתמשים בקריאות PATCH או UPDATE מנקודת הקצה Customers של Directory API.

משתמשים ב-Directory API כדי לעדכן את ערך ברירת המחדל של language ללקוח:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

כוללים את גוף הבקשה בפורמט JSON הבא:

{
  "language":"LANGUAGE_CODE"
}

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

  • CUSTOMER_ID: מזהה ייחודי של הלקוח – לדוגמה, C0123456
  • LANGUAGE_CODE: קוד שפה מקובל – לדוגמה, es לספרדית.

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

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

השלבים הבאים