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

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: खरीदार के देश का दो वर्ण वाला आईएसओ देश कोड.
• 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"
}