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

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

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

  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 لتعديل قيمة 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"
  }
}

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