تنقل هذه الطريقة تقويمًا ثانويًا بين مستخدمَين ضمن مؤسسة Google Workspace. تتطلب هذه الطريقة مصادقة المستخدم مع امتياز مشرف "إدارة التقاويم"، وأحد نطاقات التفويض التالية:
https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.calendars
useAdminAccess على true. يجب أن يكون التقويم الثانوي نشطًا لنقله. لا يمكن نقل التقاويم المحذوفة أو غير المفعّلة.
جرِّبها الآن.
طلب
طلب HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/transferOwnershipالمعلمات
| اسم المعلَمة | القيمة | الوصف |
|---|---|---|
| مَعلمات المسار | ||
calendarId |
string |
مُعرّف التقويم. لاسترداد معرّفات التقويم، يمكنك طلب بيانات من طريقة calendarList.list. |
| مَعلمات طلب البحث المطلوبة | ||
newDataOwner |
string |
عنوان البريد الإلكتروني لمستخدم سيصبح مالك بيانات التقويم. |
useAdminAccess |
boolean |
عند ضبط هذه المعلَمة على "صحيح"، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم الذي يطلب البيانات مشرفًا في Google Workspace ولديه امتياز "إدارة التقاويم". لا تتيح هذه الطريقة حاليًا سوى وصول المشرف، لذا لا يتم قبول سوى القيمة true لهذا الحقل.
|
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية:
| النطاق |
|---|
https://www.googleapis.com/auth/calendar.calendars |
https://www.googleapis.com/auth/calendar |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا تُدرِج نص طلب مع هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، تعرض نص ردّ فارغًا.
جرِّبها الآن.
استخدِم أداة "مستكشف واجهات برمجة التطبيقات" أدناه لطلب بيانات من هذه الطريقة على بيانات حقيقية والاطّلاع على الردّ.