Directory API: खरीदारों को मैनेज करना

प्रोग्राम बनाकर अपने ग्राहकों को मैनेज करने के लिए, Directory API का इस्तेमाल किया जा सकता है. इस एपीआई के तरीकों की मदद से, अपने Google Workspace डोमेन की संपर्क जानकारी अपडेट की जा सकती है. साथ ही, अपने इंस्टेंस के लिए प्राइमरी डोमेन भी बदला जा सकता है.

ग्राहक की जानकारी वापस पाना

किसी मौजूदा ग्राहक की जानकारी पाने के लिए, यहां दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति देने में बताए गए ऑथराइज़ेशन टोकन को शामिल करें. customerKey, यूनीक ग्राहक आईडी हो सकता है या मौजूदा ग्राहक को दिखाने के लिए my_customer हो सकता है.

GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey

सही जवाब मिलने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, JSON रिस्पॉन्स में ग्राहक की जानकारी भी शामिल होती है:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

किसी मौजूदा ग्राहक की जानकारी अपडेट करना

किसी मौजूदा ग्राहक की जानकारी अपडेट करने के लिए, यहां दिए गए PUT एचटीटीपी अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति देने में बताए गए ऑथराइज़ेशन टोकन को शामिल करें. customerKey, ग्राहक का यूनीक customerId हो सकता है या मौजूदा ग्राहक को दिखाने के लिए my_customer हो सकता है.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

सही जवाब मिलने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, JSON रिस्पॉन्स में ग्राहक की नई अपडेट की गई जानकारी भी शामिल होती है:

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "amatchmadeinspace.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

सही जवाब मिलने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, JSON रिस्पॉन्स में ग्राहक की जानकारी भी शामिल होती है:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

ग्राहक के प्राइमरी डोमेन नेम को बदलना

किसी ग्राहक के प्राइमरी डोमेन को बदलने के लिए, यहां दिए गए PUT एचटीटीपी अनुरोध का इस्तेमाल करें. साथ ही, अनुरोधों को अनुमति देने में बताए गए अनुमति टोकन को शामिल करें. customerKey, यूनीक customerId या my_customer होना चाहिए.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

JSON अनुरोध बॉडी में customerDomain की नई वैल्यू शामिल होनी चाहिए:

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

सही जवाब मिलने पर, एचटीटीपी 200 स्टेटस कोड दिखता है. स्टेटस कोड के साथ-साथ, JSON रिस्पॉन्स में ग्राहक की जानकारी भी शामिल होती है:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "fluxcapacitor.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}