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

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

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

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

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

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

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

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

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

סוגי לקוחות

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

  • לקוחות שאומתו באמצעות דומיין: לקוחות אלה צריכים Gmail וגישת אדמין מלאה. כשיוצרים לקוח מהסוג הזה, מגדירים את customerType לערך domain.
  • לקוחות שעברו אימות באימייל: הלקוחות האלה לא בבעלותם דומיין והם לא מנהלים אותו. כשיוצרים לקוח מהסוג הזה, מגדירים את customerType לערך team. הלקוחות האלה יכולים לרכוש את מהדורות Google Workspace Essentials ו-Google Workspace 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.

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

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

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

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

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

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

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

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

השלבים הבאים