Acl: get

ملاحظة: يجب تقديم تفويض.

تعرض قاعدة تحكُّم بالوصول. جرِّبه الآن أو شاهد مثالاً.

الطلب

طلب HTTP

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId

المَعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
calendarId	string	معرِّف التقويم. لاسترداد معرّفات التقويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم المسجّل دخوله حاليًا، استخدِم الكلمة الرئيسية "primary".
ruleId	string	معرِّف قاعدة ACL.

التفويض

يتطلب هذا الطلب إذنًا باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفِّر نص طلب بهذه الطريقة.

الإجابة

في حال نجاحها، تعرض هذه الطريقة مورد Acl في نص الاستجابة.

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

تستخدم مكتبة عميل Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.AclRule;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve access rule
AclRule rule = service.acl().get('primary', "ruleId").execute();

System.out.println(rule.getId() + ": " + rule.getRole());

Python

تستخدم مكتبة برامج Python.

rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute()

print '%s: %s' % (rule['id'], rule['role'])

PHP

لاستخدام مكتبة برامج PHP.

$rule = $service->acl->get('primary', 'ruleId');

echo $rule->getId() . ': ' . $rule->getRole();

Ruby

تستخدم مكتبة عميل Ruby.

result = client.get_acl('primary', 'ruleId')
print result.id + ": " + result.role

تجربة

يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.