Method: users.settings.cse.identities.list

यह कुकी, पुष्टि किए गए उपयोगकर्ता के लिए क्लाइंट-साइड पर एन्क्रिप्ट की गई पहचानों की सूची बनाती है.

अपने संगठन के उपयोगकर्ताओं के लिए पहचान और कुंजी जोड़े मैनेज करने वाले एडमिन को अनुरोधों के लिए अनुमति चाहिए. इसके लिए, उन्हें सेवा खाते का इस्तेमाल करना होगा. इस खाते के पास पूरे डोमेन के लिए डेलिगेशन की अनुमति होनी चाहिए, ताकि वह https://www.googleapis.com/auth/gmail.settings.basic स्कोप वाले उपयोगकर्ताओं के तौर पर काम कर सके.

अपनी पहचान और की-पेयर मैनेज करने वाले उपयोगकर्ताओं के लिए, अनुरोधों में हार्डवेयर की एन्क्रिप्शन चालू और कॉन्फ़िगर होना चाहिए.

एचटीटीपी अनुरोध

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
userId

string

अनुरोध करने वाले व्यक्ति का मुख्य ईमेल पता. प्रमाणीकरण किए गए उपयोगकर्ता के लिए, me वैल्यू का इस्तेमाल किया जा सकता है.

क्वेरी पैरामीटर

पैरामीटर
pageToken

string

पेज पर नंबर डालने वाला टोकन. इससे पता चलता है कि पहचानों का कौनसा पेज दिखाना है. अगर टोकन नहीं दिया जाता है, तो एपीआई नतीजों का पहला पेज दिखाएगा.
pageSize

integer

लौटाई जाने वाली पहचानों की संख्या. अगर यह वैल्यू नहीं दी जाती है, तो पेज का साइज़ डिफ़ॉल्ट रूप से 20 एंट्री पर सेट हो जाएगा.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "cseIdentities": [
    {
      object (CseIdentity)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
cseIdentities[]

object (CseIdentity)

उपयोगकर्ता के लिए कॉन्फ़िगर की गई सीएसई आइडेंटिटी की सूची का एक पेज.
nextPageToken

string

पेज नंबर बदलने वाला टोकन. इसका इस्तेमाल, identities.list को किए जाने वाले अगले कॉल में किया जाता है, ताकि identities का अगला पेज वापस पाया जा सके. अगर यह वैल्यू नहीं मिलती है या यह खाली स्ट्रिंग है, तो इसका मतलब है कि अब कोई और पेज नहीं है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.