העברת נתונים

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

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

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

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