نقل البيانات

لاستخدام 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 طرقًا وموارد إضافية لمساعدتك في إنشاء عمليات النقل وإدارتها، ما يتيح لك تنفيذ إجراءات مثل ما يلي:

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