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

قبل از ایجاد حساب کاربری جدید، موارد زیر را در نظر بگیرید:

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

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

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

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

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

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

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

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

شما می‌توانید دو نوع مشتری در 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 دو کاراکتری مشتری شما.
  • 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"
  }
}

مراحل بعدی