העברת נתונים

כדי להשתמש ב-Data Transfer API, מגדירים העברה ואז מפעילים אותה באמצעות השיטה insert. ההעברה מוגדרת לפי אפליקציה אחת או יותר שהנתונים שלה יועברו, ויכולה לכלול פרמטרים ספציפיים לאפליקציה.

לפניכם סיכום כללי של תהליך ההעברה:

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

  • רשימת האפליקציות הזמינות להעברת נתונים.
  • איך מקבלים מידע על אפליקציות לפי מזהה האפליקציה
  • רשימת ההעברות לפי משתמש מקור, משתמש יעד או סטטוס.
  • איך מקבלים בקשת העברה לפי מזהה המשאב