سفارش یک حساب مشتری جدید

قبل از ایجاد حساب کاربری جدید، به نکات زیر توجه کنید:

ایجاد حساب کاربری مشتری

  1. برای ایجاد یک حساب کاربری مشتری، از درخواست POST زیر استفاده کنید و توکن مجوز را وارد کنید:

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

  2. در حساب مشتری جدید، یک کاربر ایجاد کنید . اگر پاسخ، کد وضعیت HTTP 409 Conflict را برگرداند، customerId از قبل وجود دارد. قبل از ثبت حساب مشتری، باید اشتراک‌های مشتری را منتقل کنید .

  3. در صورت لزوم، زبان پیش‌فرض مشتری را تغییر دهید .

  4. کاربر را به نقش مدیر ارشد ارتقا دهید. هنگام ایجاد حساب کاربری مدیر، می‌توانید یک رمز عبور تصادفی موقت ایجاد کنید یا از مشتری بخواهید رمز عبور خود را وارد کند.

  5. به مشتری اطلاع دهید که برای فعال کردن حساب کاربری خود باید وارد کنسول مدیریت گوگل شود و با استفاده از توافقنامه نمایندگی فروش، فضای کاری گوگل را امضا کند. نمایندگان فروش مجاز به امضای شرایط خدمات از طرف مشتری نیستند.

انواع مشتریان

شما می‌توانید دو نوع مشتری در 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 دو کاراکتری مشتری.
  • 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 از نقطه پایانی Directory API Customers استفاده کنید.

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

مراحل بعدی