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

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

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

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

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

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

  3. غيِّر اللغة التلقائية للعميل، إذا كان ذلك منطبقًا.

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

  5. أبلِغ العميل بأنّه يجب تسجيل الدخول إلى "وحدة تحكّم المشرف" وتوقيع اتفاقية 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 الخاص بعميلك
  • استبدِل 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.

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

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