כדי להשתמש ב-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 כולל שיטות ומשאבים נוספים שיעזרו לכם ליצור ולנהל העברות, ולבצע פעולות כמו:
- רשימת האפליקציות הזמינות להעברת נתונים.
- איך מקבלים מידע על אפליקציות לפי מזהה האפליקציה
- רשימת ההעברות לפי משתמש מקור, משתמש יעד או סטטוס.
- איך מקבלים בקשת העברה לפי מזהה המשאב