لاسترداد قائمة بموارد التقويم لأحد الحسابات.
طلب HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
customer |
المعرّف الفريد لحساب العميل على Google Workspace بصفتك مشرفًا لحساب، يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني |
معلمات طلب البحث
المَعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد النتائج المطلوب عرضها. |
orderBy |
الحقول المطلوب ترتيب النتائج حسبها تصاعديًا أو تنازليًا. وتشمل الحقول المتاحة |
pageToken |
رمز مميز لتحديد الصفحة التالية في القائمة |
query |
استعلام السلسلة المستخدَم لفلترة النتائج. يجب أن يكون على شكل "قيمة عامل التشغيل الحقل"، حيث يمكن أن يكون الحقل أيًا من الحقول المتوافقة، ويمكن أن يكون أي من العمليات المتاحة. تتضمن عوامل التشغيل '=' للمطابقة التامة، و'!=' لعدم التطابق، و ':' لمطابقة البادئة أو مطابقة HAS حيثما ينطبق ذلك. لمطابقة البادئة، يجب أن تتبع القيمة دائمًا علامة *. ويمكن استخدام عاملَي التشغيل المنطقيين NOT وAND (بترتيب الأسبقية هذا). تشمل الحقول المتاحة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
واجهة برمجة التطبيقات العامة: Resource.calendars
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
لتحديد ذلك كمجموعة من موارد التقويم. دائمًا ما يكون |
etag |
علامة ETag للمورد. |
items[] |
موارد التقويم في هذه الصفحة من النتائج |
nextPageToken |
الرمز المميز للمتابعة، المستخدم للصفحات في مجموعات النتائج الكبيرة. قدِّم هذه القيمة في طلب لاحق لعرض الصفحة التالية من النتائج. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.