באמצעות Data Portability API תוכלו ליצור אפליקציות שמבקשות ממשתמש הרשאה להעביר עותק של נתונים משירותי Google לאפליקציה שלכם. כך אפשר לניידות נתונים ולעבור בין שירותים.
רוצים לדעת איך משתמשים משתפים נתונים? קראו את המאמר שיתוף עותק של הנתונים עם צד שלישי.
דרישות מוקדמות
לפני פרסום האפליקציה, היא צריכה לקבל אישור מ-Google.
בנוסף, חשוב לוודא ש-Data Portability API זמין למשתמשים במיקום שלכם. לרשימת המדינות והאזורים הנתמכים, ראו שאלות נפוצות בדף 'שיתוף עותק של הנתונים שלך עם צד שלישי'.
זרימת עבודה של מפתחים
אלה השלבים ליצירת אפליקציה שמשתמשת ב-Data Portability API.
הטמעת תהליך ההסכמה של OAuth עבור המשתמש. בדוגמה הזו, המשתמש מספק גישה לנתוני הסרטון ב-YouTube.
המשתמש לוחץ על ייבוא סרטונים מ-YouTube ונכנס לחשבון Google.
האפליקציה מעבירה את המשתמש לכתובת URL להבעת הסכמה ב-OAuth. שימו לב שכתובת ה-URL לדוגמה הזו פשוטה יותר, וחסרים בה כמה פרמטרים:
https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube
המשתמש לוחץ על Next במסך ההסכמה של OAuth, מסכים לשתף את הנתונים שלו ומאפשר גישה לחשבון.
המשתמש מופנה לאפליקציה.
המפתח מקבל אסימון OAuth עבור המשתמש.
האפליקציה מפעילה את
InitiatePortabilityArchive(resources = ["myactivity.youtube"])
עם אסימון OAuth מצורף שכולל את היקף ההרשאות הזה של OAuth:https://www.googleapis.com/auth/dataportability.myactivity.youtube
הקריאה הזו מתחילה בתהליך היצירה של ארכיון הנתונים. יש להפעיל את ארכיון הניידות תוך 24 שעות מרגע הרשאת המשתמש.
האפליקציה מפעילה את
GetPortabilityArchiveState(job_id)
באמצעות אסימון OAuth מצורף שכולל את היקף ההרשאות הזה של OAuth:https://www.googleapis.com/auth/dataportability.myactivity.youtube
אפשר לקרוא לשיטה הזו כמה פעמים כדי לאחזר את הסטטוס של משימת הארכיון. השיטה מחזירה את מצב המשימה. כשהמצב הושלם, הארכיון מוכן וכתובות ה-URL של Cloud Storage חתומות. שימו לב שמשך הזמן שנדרש להשלמת הבקשה לארכיון עשוי להשתנות בין דקות לשעות, בהתאם לגודל הנתונים.
מורידים את ארכיון הנתונים באמצעות כתובות ה-URL החתומות.
אפשר להפעיל את
ResetAuthorization()
עם אסימון OAuth מצורף, כדי לאפס את המשאבים שמומשו ולהסיר את כל ההסכמות ל-OAuth.
מידע נוסף על השימוש בשיטות Data Portability API זמין במאמר שיטות של Call Data Portability API.
איך משתמשים מקיימים אינטראקציה עם אפליקציית Data Portability API
בתרשים הזה מוצג האופן שבו משתמשים מקיימים אינטראקציה עם אפליקציה שמשולבת עם Data Portability API.
קודם כל, מוצגת למשתמש אפשרות לאחזר את הנתונים שלו.
לאחר מכן, המשתמש נכנס לחשבון Google שלו.
לאחר מכן המשתמש לוחץ על Next כשמוצגת לו בקשה לשתף את הנתונים, ולוחצים על הבנתי כשמוצגת לו בקשה לאשר את מדיניות הפרטיות.
לאחר מכן מוצג למשתמש מסך הסכמה מסוג OAuth שמאפשר לאפליקציה לגשת לנתונים. האפשרויות כאן תואמות להיקפי ההרשאות של OAuth שהגדרתם.
ייבוא הנתונים מתחיל לאחר אישור הגישה. בהתאם לגודל הנתונים, השלמת הבקשה עשויה להימשך בין כמה דקות לכמה שעות.