نقل البيانات

لاستخدام 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 طرقًا وموارد إضافية ل help you construct and administer transfers، ما يتيح لك تنفيذ إجراءات مثل:

  • أدرِج التطبيقات المتاحة لنقل البيانات.
  • الحصول على معلومات التطبيق حسب رقم تعريف التطبيق
  • قائمة عمليات النقل حسب المستخدم المصدر أو المستخدم الوجهة أو الحالة
  • الحصول على طلب نقل حسب رقم تعريف المورد