برای استفاده از 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 شامل روش‌ها و منابع اضافی برای کمک به شما در ساخت و مدیریت انتقال است و به شما امکان می‌دهد کارهایی مانند موارد زیر را انجام دهید:
- لیست برنامه های کاربردی موجود برای انتقال داده
- اطلاعات برنامه را با شناسه برنامه دریافت کنید .
- نقل و انتقالات را بر اساس کاربر مبدأ، کاربر مقصد یا وضعیت فهرست کنید .
- درخواست انتقال را با شناسه منبع دریافت کنید .