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

لاسترداد معلومات أحد العملاء وتعديلها باستخدام 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. لإنشاء حساب عميل تم إثبات ملكية نطاقه، اطلب من العميل شراء اشتراك مباشر وإثبات ملكية نطاقه، ثم نقل الاشتراك.

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

  1. تأكَّد من أنّ سجلّاتك لا تتضمّن بيانات عملاء قديمة لا تتطابق مع اسم النطاق الأساسي ومعرّف العميل الفريد على Google. عند إعادة تفعيل حساب محذوف، يتم التعامل معه على أنّه حساب جديد يتضمّن customerId جديدًا.
  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"
}