استرداد معلومات حساب العميل وتحديثها

لاسترداد معلومات العميل وتعديلها باستخدام Reseller API، لديك طريقتان للبحث عن عميلك:

  • المعرّف الفريد للعميل، على سبيل المثال C0123456
  • اسم نطاق العميل، على سبيل المثال example.com

استرداد معلومات حساب العميل

لاسترداد معلومات حساب العميل، استخدِم طلب GET التالي وأدرِج رمز التفويض:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

استبدِل CUSTOMER_ID بالمعرّف أو اسم النطاق الفريدَين للعميل.

عمليات عرض الردود

عند استرداد معلومات حساب العميل، قد تتلقّى أحد الرسائل التالية:

  • عرض إعدادات العميل الكاملة العميل هو أحد عملائك الحاليين. باستخدام Reseller API، يمكنك إدارة حساب العميل وإعدادات اشتراكه.

  • تعرض الحد الأدنى لمعلومات حساب العميل. إذا كان الردّ يعرضcustomerId وcustomerDomain وcustomerType فقط، يعني ذلك أنّ العميل يدير إما Google أو مورّد آخر. لا يمكنك إنشاء عميل آخر تم إثبات هويته باستخدام البريد الإلكتروني للعميل. لإدارة هذا العميل، اتّبِع الخطوات التالية:

    1. استرداد جميع الاشتراكات القابلة للنقل للعميل لمعرفة ما إذا كان يمكن نقل الاشتراك ومعرفة الحد الأدنى لعدد مقاعد المستخدمين لإجراء عملية النقل
    2. نقل الاشتراك

  • المرتجعات Multiple teams exist on this domain يحتوي هذا النطاق على عميل واحد أو أكثر على مستوى الفريق مرتبط به. لإضافة فريق آخر إلى هذا النطاق، اتّبِع الخطوات التالية:

    1. طلب حساب عميل
    2. لإنشاء حساب عميل أُثبِتَت ملكيته باستخدام النطاق، اطلب من العميل شراء اشتراك مباشر من خلال Google وإثبات ملكية نطاقه والاستيلاء على الفِرق الحالية ثم نقل الاشتراك إلى حسابك.

  • يعرض خطأ HTTP 404. العميل جديد في Google وليس لديه حساب. لإدارة هذا العميل، اتّبِع الخطوات التالية:

    1. تأكَّد من أنّ سجلّات العملاء لا تحتوي على بيانات عملاء قديمة تتضمّن عدم تطابق محتمل بين اسم النطاق الأساسي للعميل و معرّف العميل الفريد في Google. عند إعادة حساب Google تم حذفه سابقًا، تتم معالجته كحساب جديد ويتم ضبط قيمة جديدة لـ customerId على الرغم من أنّ الحساب قد يحتفظ بالقيمة نفسها لـ customerDomain.
    2. طلب حساب عميل جديد
    3. أنشئ اشتراكًا لحساب العميل الجديد هذا.

تعديل إعدادات أحد العملاء

باستخدام Reseller API، لا يمكنك تعديل customerType، ولكن يمكنك إثبات ملكية نطاق عميل team والحصول على اشتراك domain.

لتعديل إعدادات عميل، استخدِم طلب PUT التالي مع تضمين المعرّف الفريد للعميل:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

يعدّل نص طلب JSON إعدادات العميل التالية:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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.

تعرض استجابة JSON الناجحة رمز حالة HTTP 200 و إعدادات العميل المعدَّلة:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}