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

لاسترداد معلومات أحد العملاء وتعديلها باستخدام 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"
}