לפני שיוצרים חשבון לקוח חדש, כדאי להביא בחשבון את הנקודות הבאות:
- ייתכנו הגבלות על קידומת החיוג של המדינה. כדי לוודא שהמדינה של הלקוח אושרה למכירה חוזרת, נכנסים למסוף Partner Sales.
- אם החשבון נוצר על ידי שדרוג מחשבון Gmail לצרכנים לכתובת אימייל עסקית עם שם דומיין, צריך לוודא שלחשבון יש הגדרות נוספות של Google Workspace. למידע נוסף, תוכלו לקרוא את המאמרים יצירת כתובות אימייל עסקיות לצוות שלכם ויצירת כתובת אימייל חלופית לעסק.
יצירת חשבון לקוח
כדי ליצור חשבון לקוח, צריך להשתמש בבקשת
POST
הבאה ולכלול את אסימון ההרשאה:POST https://reseller.googleapis.com/apps/reseller/v1/customers
בחשבון של הלקוח החדש, יוצרים משתמש. במקרה שהתגובה מחזירה קוד סטטוס HTTP
409 Conflict
,customerId
כבר קיים. לפני הרישום של חשבון הלקוח, צריך להעביר את המינויים של הלקוח.אם רלוונטי, משנים את שפת ברירת המחדל של הלקוח.
לקדם את המשתמש לתפקיד סופר-אדמין. כשיוצרים את חשבון האדמין, אפשר ליצור סיסמה אקראית זמנית או לבקש מהלקוח לספק סיסמה.
כדי להפעיל את החשבון שלו, עליך להודיע ללקוח שעליו להיכנס למסוף 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
.
תגובה מוצלחת מחזירה את קוד הסטטוס 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" } }