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

لاسترداد معلومات العميل وتعديلها باستخدام واجهة برمجة تطبيقات المورّد، يمكنك اتّباع إحدى الطريقتَين التاليتَين للبحث عن العميل:

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

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

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

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

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

إرجاع الردّ

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

  • عرض إعدادات العميل الكاملة العميل هو أحد عملاءك الحاليين. باستخدام واجهة برمجة تطبيقات المورّد، يمكنك إدارة إعدادات حساب العميل واشتراكه.

  • عرض الحد الأدنى من معلومات حساب العميل. إذا عرض الرد 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. أنشئ اشتراكًا لحساب العميل الجديد هذا.

تعديل إعدادات عميل

باستخدام واجهة برمجة تطبيقات المورّد، لا يمكنك تعديل "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"
}