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

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

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

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

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

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

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

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

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

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

يمكنك إنشاء نوعَين من العملاء على 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.

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

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