نقل البيانات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاستخدام 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 طرقًا وموارد إضافية ل help you construct and administer transfers، ما يتيح لك تنفيذ إجراءات مثل:
- أدرِج
التطبيقات المتاحة لنقل البيانات.
- الحصول
على معلومات التطبيق حسب رقم تعريف التطبيق
- قائمة عمليات النقل حسب
المستخدم المصدر أو المستخدم الوجهة أو الحالة
- الحصول على طلب نقل
حسب رقم تعريف المورد
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Transfer data\n\nTo use the Data Transfer API, you define a transfer and then initiate\nit using the `insert` method. The transfer is defined in terms of one or more\napplications whose data will be transferred, and can include\n[application-specific parameters](/workspace/admin/data-transfer/v1/parameters).\n\nThe following is a high-level summary of the transfer process:\n\n1. Determine the applications for which you want to transfer data.\n2. Define a [`DataTransfer` resource](/workspace/admin/data-transfer/reference/rest/v1/transfers) that specifies the source and destination users and the applications for which to transfer data.\n3. Initiate the transfer by using the [`insert()` method](/workspace/admin/data-transfer/reference/rest/v1/transfers/insert).\n\nFor example, the following JSON request body transfers a calendar from\nthe source user (\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e) to the destination user\n(\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e). You can retrieve the user IDs for\neach owner by calling the\n[`user.get()` method](/workspace/admin/directory/reference/rest/v1/users/get)\nof the Directory API and providing their email address or email alias. \n\n {\n \"oldOwnerUserId\": \"\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e\",\n \"newOwnerUserId\": \"\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e\",\n \"applicationDataTransfers\": [\n {\n \"applicationId\": \"435070579839\",\n \"applicationTransferParams\": [\n {\n \"key\": \"RELEASE_RESOURCES\",\n \"value\": [\n \"TRUE\"\n ]\n }\n ]\n }\n ]\n }\n\nRelated topics\n--------------\n\nThe Data Transfer API includes additional methods and resources to\nhelp you construct and administer transfers, allowing you to do things like\nthe following:\n\n- [List](/workspace/admin/data-transfer/v1/reference/applications/list) applications available for data transfer.\n- [Get](/workspace/admin/data-transfer/v1/reference/applications/get) application information by application ID.\n- [List](/workspace/admin/data-transfer/v1/reference/transfers/list) transfers by source user, destination user, or status.\n- [Get](/workspace/admin/data-transfer/v1/reference/transfers/get) a transfer request by resource ID."]]