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 तय करना होगा, नहीं तो इनडायरेक्ट रोल असाइनमेंट शामिल नहीं किए जाएंगे.

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

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

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

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

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

string

एपीआई संसाधन का टाइप. यह हमेशा admin#directory#roleAssignments होता है.

etag

string

संसाधन का ईटैग.

items[]

object (RoleAssignment)

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

nextPageToken

string

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

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

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

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