העברת נתונים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כדי להשתמש ב-Data Transfer API, מגדירים העברה ואז מפעילים אותה באמצעות השיטה insert
. ההעברה מוגדרת לפי אפליקציה אחת או יותר שהנתונים שלה יועברו, ויכולה לכלול פרמטרים ספציפיים לאפליקציה.
לפניכם סיכום כללי של תהליך ההעברה:
- קובעים אילו אפליקציות רוצים להעביר נתונים מהן.
- מגדירים משאב
DataTransfer
שמציין את המשתמשים במקור וביעד ואת האפליקציות שעבורן רוצים להעביר נתונים.
- מפעילים את ההעברה באמצעות השיטה
insert()
.
לדוגמה, הגוף הבא של בקשת JSON מעביר יומן ממשתמש המקור (SOURCE_USER_ID
) למשתמש היעד (DESTINATION_USER_ID
). תוכלו לאחזר את מזהי המשתמשים של כל אחד מהבעלים על ידי קריאה לשיטה user.get()
של ה-Directory API ושליחת כתובת האימייל או כתובת האימייל החלופית שלו.
{
"oldOwnerUserId": "SOURCE_USER_ID",
"newOwnerUserId": "DESTINATION_USER_ID",
"applicationDataTransfers": [
{
"applicationId": "435070579839",
"applicationTransferParams": [
{
"key": "RELEASE_RESOURCES",
"value": [
"TRUE"
]
}
]
}
]
}
Data Transfer API כולל שיטות ומשאבים נוספים שיעזרו לכם ליצור ולנהל העברות, ולבצע פעולות כמו:
- רשימת האפליקציות הזמינות להעברת נתונים.
- איך מקבלים מידע על אפליקציות לפי מזהה האפליקציה
- רשימת ההעברות לפי משתמש מקור, משתמש יעד או סטטוס.
- איך מקבלים בקשת העברה לפי מזהה המשאב
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-25 (שעון UTC)."],[],[],null,["# Transfer data\n\nTo use the Data Transfer API, you define a transfer and then initiate\nit using the `insert` method. The transfer is defined in terms of one or more\napplications whose data will be transferred, and can include\n[application-specific parameters](/workspace/admin/data-transfer/v1/parameters).\n\nThe following is a high-level summary of the transfer process:\n\n1. Determine the applications for which you want to transfer data.\n2. Define a [`DataTransfer` resource](/workspace/admin/data-transfer/reference/rest/v1/transfers) that specifies the source and destination users and the applications for which to transfer data.\n3. Initiate the transfer by using the [`insert()` method](/workspace/admin/data-transfer/reference/rest/v1/transfers/insert).\n\nFor example, the following JSON request body transfers a calendar from\nthe source user (\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e) to the destination user\n(\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e). You can retrieve the user IDs for\neach owner by calling the\n[`user.get()` method](/workspace/admin/directory/reference/rest/v1/users/get)\nof the Directory API and providing their email address or email alias. \n\n {\n \"oldOwnerUserId\": \"\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e\",\n \"newOwnerUserId\": \"\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e\",\n \"applicationDataTransfers\": [\n {\n \"applicationId\": \"435070579839\",\n \"applicationTransferParams\": [\n {\n \"key\": \"RELEASE_RESOURCES\",\n \"value\": [\n \"TRUE\"\n ]\n }\n ]\n }\n ]\n }\n\nRelated topics\n--------------\n\nThe Data Transfer API includes additional methods and resources to\nhelp you construct and administer transfers, allowing you to do things like\nthe following:\n\n- [List](/workspace/admin/data-transfer/v1/reference/applications/list) applications available for data transfer.\n- [Get](/workspace/admin/data-transfer/v1/reference/applications/get) application information by application ID.\n- [List](/workspace/admin/data-transfer/v1/reference/transfers/list) transfers by source user, destination user, or status.\n- [Get](/workspace/admin/data-transfer/v1/reference/transfers/get) a transfer request by resource ID."]]