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

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

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

תגובה מוצלחת מחזירה את קוד הסטטוס 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"
}

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

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

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

השלבים הבאים

• שגיאות נפוצות ב-Seller API
• שגיאות נפוצות ב-Directory API