طلب حساب عميل جديد

قبل إنشاء حساب عميل جديد، يجب مراعاة ما يلي:

إنشاء حساب عميل

  1. لإنشاء حساب عميل، استخدِم طلب POST التالي وأدرِج رمز التفويض:

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

  2. ضمن حساب العميل الجديد، أنشئ مستخدمًا. إذا كان الردّ يعرض رمز حالة HTTP‏ 409 Conflict، يعني ذلك أنّ customerId متوفّر. قبل تسجيل حساب العميل، عليك نقل اشتراكات العميل.

  3. غيِّر لغة العميل التلقائية، إن أمكن.

  4. صعِّد المستخدم إلى دور المشرف المتميّز. عند إنشاء حساب المشرف، يمكنك إنشاء كلمة مرور مؤقتة عشوائية أو مطالبة العميل بتقديم كلمة مرور.

  5. أطلِع العميل على أنّه عليه تسجيل الدخول إلى "وحدة تحكّم المشرف" و signing the Google Workspace via Reseller agreement لتفعيل حسابه. يُحظر على المورّدين التوقيع على بنود الخدمة بالنيابة عن العميل.

أنواع العملاء

يمكنك إنشاء نوعَين من العملاء على Google Workspace:

  • العملاء الذين تم إثبات ملكيتهم للنطاق: يحتاج هؤلاء العملاء إلى Gmail وإلى إذن وصول المشرف الكامل. عند إنشاء هذا النوع من العملاء، اضبط customerType على domain.
  • العملاء الذين تم إثبات ملكية بريدهم الإلكتروني: لا يملك هؤلاء العملاء نطاقهم أو يديرونه. عند إنشاء هذا النوع من العملاء، اضبط customerType على team. يمكن لهذا النوع من العملاء شراء إصدارَي Google Workspace Essentials وEnterprise Essentials.

إليك مثال على نموذج طلب 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.

استخدِم 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"
  }
}

الخطوات التالية