Method: resources.calendars.list

किसी खाते के लिए कैलेंडर संसाधनों की सूची दिखाता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
customer

string

ग्राहक के Google Workspace खाते का यूनीक आईडी. खाते के एडमिन के तौर पर, अपने खाते के ग्राहक आईडी को दिखाने के लिए, my_customer उपनाम का भी इस्तेमाल किया जा सकता है.

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

पैरामीटर
maxResults

integer

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

string

नतीजों को बढ़ते या घटते क्रम में लगाने के लिए फ़ील्ड. इस्तेमाल किए जा सकने वाले फ़ील्ड में resourceId, resourceName, capacity, buildingId, और floorName शामिल हैं. अगर कोई क्रम तय नहीं किया गया है, तो डिफ़ॉल्ट रूप से बढ़ते क्रम में लगाया जाता है. यह "फ़ील्ड [asc|desc], फ़ील्ड [asc|desc], ..." फ़ॉर्मैट में होना चाहिए. उदाहरण के लिए, buildingId, capacity desc से पहले buildingId के हिसाब से, फिर capacity के हिसाब से, बढ़ते क्रम में नतीजे मिलेंगे.
pageToken

string

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

string

नतीजों को फ़िल्टर करने के लिए इस्तेमाल की जाने वाली स्ट्रिंग क्वेरी. यह "फ़ील्ड ऑपरेटर वैल्यू" फ़ॉर्मैट में होना चाहिए. इसमें फ़ील्ड, काम करने वाले किसी भी फ़ील्ड के तौर पर और ऑपरेटर, काम करने वाले किसी भी ऑपरेशन के तौर पर हो सकते हैं. ऑपरेटर में एग्ज़ैक्ट मैच के लिए '=', मैच न होने के लिए '!=', और प्रीफ़िक्स मैच या लागू होने पर HAS मैच के लिए ':' शामिल होता है. प्रीफ़िक्स मैच के लिए, वैल्यू के बाद हमेशा * होना चाहिए. लॉजिकल ऑपरेटर NOT और AND का इस्तेमाल किया जा सकता है (इस क्रम में प्राथमिकता दी जाती है). इन फ़ील्ड में वैल्यू डाली जा सकती है: generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail, resourceCategory. उदाहरण के लिए, buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone.

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

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

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

सार्वजनिक API: Resources.calendars

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

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

string

यह CalendarResources के कलेक्शन के तौर पर पहचान करता है. यह हमेशा admin#directory#resources#calendars#calendarResourcesList होती है.
etag

string

संसाधन का ETag.
items[]

object (CalendarResource)

नतीजों के इस पेज में CalendarResources.
nextPageToken

string

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

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

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

  • https://apps-apis.google.com/a/feeds/calendar/resource/
  • https://www.googleapis.com/auth/admin.directory.resource.calendar
  • https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

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