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

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

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

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

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