Directory API: ग्राहकों को मैनेज करें

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

किसी ग्राहक को वापस लाएं

किसी मौजूदा ग्राहक को वापस पाने के लिए, यहां दिए गए 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, ग्राहक का यूनीक ग्राहक आईडी हो सकता है या मौजूदा ग्राहक की जानकारी देने के लिए 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 को यूनीक ग्राहक आईडी या 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"
}