כדי להשתמש ב-Data Transfer API, צריך להגדיר העברה ולהתחיל אותה בשיטה insert
. ההעברה מוגדרת לפי אפליקציה אחת או יותר שהנתונים שלהן יועברו, והיא יכולה לכלול פרמטרים ספציפיים לאפליקציה.
לפניכם סיכום כללי של תהליך ההעברה:
- בוחרים את האפליקציות שעבורן רוצים להעביר נתונים.
- מגדירים משאב
DataTransfer
שמציין את המשתמשים במקור וביעד ואת האפליקציות שאליהן יועברו הנתונים. - מתחילים את ההעברה באמצעות השיטה
insert()
.
לדוגמה, גוף בקשת ה-JSON הבא מעביר יומן ממשתמש המקור (SOURCE_USER_ID
) למשתמש היעד (DESTINATION_USER_ID
). אפשר לאחזר את מזהי המשתמשים של כל בעלים באמצעות קריאה ל-method user.get()
של ה-Directory API וציון כתובת האימייל או כתובת האימייל החלופית שלו.
{
"oldOwnerUserId": "SOURCE_USER_ID",
"newOwnerUserId": "DESTINATION_USER_ID",
"applicationDataTransfers": [
{
"applicationId": "435070579839",
"applicationTransferParams": [
{
"key": "RELEASE_RESOURCES",
"value": [
"TRUE"
]
}
]
}
]
}
נושאים קשורים
ב-Data Transfer API יש שיטות ומשאבים נוספים שיעזרו לכם ליצור ולנהל את ההעברות, וכך לבצע פעולות כמו:
- רשימה של האפליקציות הזמינות להעברת נתונים.
- קבלת פרטי האפליקציה לפי מזהה האפליקציה.
- רשימה של העברות לפי משתמש המקור, משתמש היעד או הסטטוס.
- מקבלים בקשת העברה לפי מזהה המשאב.