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 फ़ील्ड शामिल हैं. अगर कोई ऑर्डर नहीं बताया गया है, तो डिफ़ॉल्ट रूप से बढ़ते क्रम में होता है. यह [field] [asc|diff], फ़ील्ड [asc|diff], ..." फ़ॉर्म में होना चाहिए. उदाहरण के लिए, buildingId, capacity desc के नतीजों को पहले, buildingId के हिसाब से बढ़ते क्रम में. फिर घटते क्रम में capacity.

pageToken

string

सूची में अगले पेज के बारे में बताने के लिए टोकन.

query

string

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

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

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

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

सार्वजनिक एपीआई: resource.calendars

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

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

string

इसे CalendarResources के संग्रह के रूप में पहचाना जाता है. यह वैल्यू हमेशा admin#directory#resources#calendars#calendarResourcesList होती है.

etag

string

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

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

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