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

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

• قد يتم فرض قيود على رمز البلد. للتأكُّد من أنّه تمت الموافقة على إعادة البيع في بلد العميل، يُرجى الاطّلاع على وحدة التحكّم في مبيعات الشركاء.
• إذا تم إنشاء الحساب من خلال الترقية من حساب Gmail للمستهلك إلى بريد إلكتروني للنشاط التجاري يحمل اسم نطاق، تأكَّد من أنّه تم فتح قفل إعدادات Google Workspace الإضافية في الحساب. لمزيد من المعلومات، يمكنك الاطّلاع على إنشاء عناوين بريد إلكتروني للنشاط التجاري لفريقك وإنشاء عنوان بريد إلكتروني بديل خاص بالنشاط التجاري.

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

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"
  }
}

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

• الأخطاء الشائعة في واجهة برمجة تطبيقات المورّد
• الأخطاء الشائعة في Directory API