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

لاسترداد معلومات أحد العملاء وتعديلها باستخدام 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 بعنوان البريد الإلكتروني الخاص بالعميل، مثلاً [e-mail].

تعرض استجابة 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"
}