העברה של יומן משני בין משתמשים בארגון 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 |
אם הערך הוא true, השיטה פועלת באמצעות הרשאות האדמין של המשתמש ב-Google Workspace. המשתמש שמתקשר צריך להיות אדמין ב-Google Workspace עם הרשאת ניהול לוחות שנה. השיטה הזו תומכת כרגע רק בגישת אדמין, ולכן רק true מתקבל בשדה הזה.
|
אישור
כדי לבצע את הבקשה הזו, צריך להעניק הרשאה עם אחת מההיקפים הבאים:
| היקף |
|---|
https://www.googleapis.com/auth/calendar.calendars |
https://www.googleapis.com/auth/calendar |
למידע נוסף, ראו את הדף אימות והרשאה.
גוף הבקשה
אין לספק גוף בקשה עם השיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, מוחזר גוף תגובה ריק.
רוצה לנסות?
אפשר להשתמש בכלי APIs Explorer שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.