Method: resources.calendars.list

تسترد هذه الطريقة قائمة بموارد التقويم لحساب معيّن.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

واجهة برمجة التطبيقات العامة: 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)

تمثّل هذه السمة موارد التقويم في هذه الصفحة من النتائج.
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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.