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

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

• ग्राहक का यूनीक आइडेंटिफ़ायर—उदाहरण के लिए, C0123456
• ग्राहक का डोमेन नेम—उदाहरण के लिए, example.com

किसी ग्राहक के खाते की जानकारी फिर से पाएं

किसी ग्राहक के खाते की जानकारी पाने के लिए, GET का यह अनुरोध करें और ऑथराइज़ेशन टोकन शामिल करें:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

CUSTOMER_ID को अपने ग्राहक के यूनीक आइडेंटिफ़ायर या डोमेन नेम से बदलें.

जवाब दिया जाता है

किसी ग्राहक के खाते की जानकारी फिर से हासिल करने पर, आपको इनमें से कोई एक जवाब मिल सकता है:

• ग्राहक की पूरी सेटिंग दिखाता है. ग्राहक आपके मौजूदा ग्राहकों में से एक है. रीसेलर एपीआई का इस्तेमाल करके, इस ग्राहक का खाता और सदस्यता सेटिंग मैनेज की जा सकती हैं.

• ग्राहक के खाते की कम से कम जानकारी दिखाता है. अगर जवाब में सिर्फ़ customerId, customerDomain, और customerType दिखता है, तो Google या कोई दूसरा रीसेलर ग्राहक को मैनेज करता है. इस ग्राहक के लिए, ईमेल से पुष्टि करने वाला दूसरा ग्राहक नहीं बनाया जा सकता. इस ग्राहक को मैनेज करने के लिए, यह तरीका अपनाएं:

  1. ग्राहक को ट्रांसफ़र की जा सकने वाली सभी सदस्यताओं को वापस लाएं, ताकि यह समझा जा सके कि सदस्यता को ट्रांसफ़र किया जा सकता है या नहीं. साथ ही, ट्रांसफ़र के लिए उपयोगकर्ताओं की कम से कम संख्या की जानकारी भी दें.
  2. सदस्यता ट्रांसफ़र करें.

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

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

• यह एचटीटीपी 404 गड़बड़ी दिखाता है. ग्राहक Google पर नया है और उसके पास कोई खाता नहीं है. इस ग्राहक को मैनेज करने के लिए, यह तरीका अपनाएं:

  1. पक्का करें कि आपके ग्राहक के रिकॉर्ड में, ग्राहक का पुराना डेटा मौजूद न हो और उस डेटा में ग्राहक के प्राइमरी डोमेन नेम और यूनीक Google ग्राहक आइडेंटिफ़ायर से मेल न खाने की संभावना हो. जब मिटाए गए किसी Google खाते को फिर से चालू किया जाता है, तो उसे नया खाता माना जाता है और उसकी नई customerId वैल्यू होती है. भले ही, खाते की customerDomain वैल्यू पहले जैसी ही हो.
  2. नया ग्राहक खाता ऑर्डर करें.
  3. इस नए ग्राहक खाते के लिए, सदस्यता बनाएं.

ग्राहक की सेटिंग अपडेट करें

रीसेलर एपीआई का इस्तेमाल करके, 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: आपके ग्राहक के लिए दो वर्ण का आईएसओ देश कोड.
• 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"
}