किसी ग्राहक के खाते की जानकारी वापस पाएं और उसे अपडेट करें

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 गड़बड़ी का जवाब मिलता है: ग्राहक, 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 का सही जवाब मिलने पर, एचटीटीपी 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"
}