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

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

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

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

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

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

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

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

  5. به مشتری اطلاع دهید که باید به کنسول Admin وارد شود و Google Workspace را از طریق قرارداد 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 2 کاراکتری مشتری شما.
  • 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 استفاده کنید.

از 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 موفق یک کد وضعیت 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"
  }
}

مراحل بعدی