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

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. डोमेन की पुष्टि किए गए ग्राहक के तौर पर किसी ग्राहक का खाता बनाने के लिए, उससे कहें कि वह 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"
}