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

रीसेलर एपीआई का इस्तेमाल करके, किसी ग्राहक की जानकारी पाने और उसे अपडेट करने के लिए, आपके पास ग्राहक को खोजने के दो तरीके हैं:

• ग्राहक का यूनीक आइडेंटिफ़ायर—उदाहरण के लिए, 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. सदस्यता ट्रांसफ़र करें.

• Returns Multiple teams exist on this domain दिखाता है. इस डोमेन से एक या एक से ज़्यादा टीम ग्राहक जुड़े हैं. इस डोमेन में कोई और टीम जोड़ने के लिए, यह तरीका अपनाएं:

  1. ग्राहक खाता ऑर्डर करना.
  2. डोमेन के लिए, डोमेन की पुष्टि किया गया ग्राहक बनाने के लिए, ग्राहक से कहें कि वह Google से सीधे तौर पर सदस्यता खरीदे और अपने डोमेन की पुष्टि करे. साथ ही, मौजूदा टीमों को अपने कब्ज़े में ले ले. इसके बाद, सदस्यता को अपने खाते में ट्रांसफ़र करे.

• एचटीटीपी 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 फ़ॉर्मैट में सही जवाब मिलने पर, एचटीटीपी 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"
}