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

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

• עשויות לחול הגבלות על קוד המדינה. כדי לוודא שמאפיין קיבל אישור להפצה, צריך לבדוק במסוף Partner Sales.
• אם החשבון נוצר על ידי שדרוג מחשבון Gmail פרטי לכתובת אימייל עסקית עם שם דומיין, צריך לוודא שהחשבון יש הגדרות נוספות של Google Workspace. מידע נוסף זמין במאמר הבא: יצירת כתובות אימייל עסקיות לצוות וגם יוצרים כתובת אימייל חלופית לעסק.

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

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: בן 2 תווים של הלקוח קוד מדינה לפי תקן ISO.
• EMAIL_ADDRESS: כתובת האימייל של הלקוח שלכם – עבור לדוגמה, [e-mail].

תשובה מוצלחת תחזיר קוד סטטוס 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 קריאות מ-Directory API לקוחות נקודת הקצה.

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

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

השלבים הבאים

• שגיאות נפוצות ב-API של המפיץ
• שגיאות נפוצות ב-Directory API