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.

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

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

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

सार्वजनिक एपीआई: Resource.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

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