Method: roleAssignments.list

सभी roleAssignments की पेज की गई सूची को वापस लाता है.

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

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments

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

पाथ पैरामीटर

पैरामीटर
customer

string

ग्राहक के Google Workspace खाते का यूनीक आईडी. एक से ज़्यादा डोमेन वाले खाते के मामले में, किसी ग्राहक के सभी ग्रुप फ़ेच करने के लिए, domain के बजाय इस फ़ील्ड का इस्तेमाल करें. अपने खाते के customerId को दिखाने के लिए, my_customer उपनाम का भी इस्तेमाल किया जा सकता है. customerId को उपयोगकर्ता संसाधन के हिस्से के तौर पर भी दिखाया जाता है. आपको customer या domain पैरामीटर में से कोई एक देना होगा.

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

पैरामीटर
maxResults

integer

कितने नतीजे दिखाने हैं.

pageToken

string

सूची में अगले पेज की जानकारी देने वाला टोकन.

roleId

string

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

userKey

string

मुख्य ईमेल पता, दूसरा ईमेल पता या उपयोगकर्ता या ग्रुप का यूनीक आईडी. अगर अनुरोध में शामिल किया गया है, तो सिर्फ़ इस उपयोगकर्ता या ग्रुप के लिए भूमिकाएं असाइन की गई हैं.

includeIndirectRoleAssignments

boolean

true पर सेट होने पर, सीधे तौर पर असाइन की गई भूमिकाओं के साथ-साथ, किसी ग्रुप के ज़रिए असाइन की गई भूमिकाओं की जानकारी भी फ़ेच की जाती है. डिफ़ॉल्ट रूप से, यह false पर सेट होती है. आपको userKey की जानकारी देनी होगी. ऐसा न करने पर, भूमिका के लिए असाइन किए गए इनडायरेक्ट ऐक्सेस को शामिल नहीं किया जाएगा.

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

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

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

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

JSON के काेड में दिखाना
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

एपीआई रिसॉर्स का टाइप. यह हमेशा admin#directory#roleAssignments होती है.

etag

string

संसाधन का ETag.

items[]

object (RoleAssignment)

RoleAssignment संसाधनों की सूची.

nextPageToken

string

अनुमति के दायरे

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

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.