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

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

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

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

השלבים הבאים