نقل البيانات من Google Drive Android API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم إيقاف واجهة برمجة التطبيقات Drive Android نهائيًا اعتبارًا من 6 كانون الأول (ديسمبر) 2018، وسيتم إيقافها بالكامل في 1 شباط (فبراير) 2023.
المخطط الزمني
| التاريخ |
حالة واجهة برمجة التطبيقات Drive Android API |
| 6 كانون الأول (ديسمبر) 2018 |
يتم الإعلان عن الإيقاف نهائيًا بشكل علني. سيتمكّن العملاء الحاليون من الوصول إلى واجهة برمجة التطبيقات بشكل طبيعي، ولكن عليهم البدء فورًا في نقل البيانات. يجب ألا يستخدم العملاء الجدد واجهة برمجة التطبيقات.
|
| 21 أكتوبر 2019 |
تمت إزالة واجهة برمجة التطبيقات Drive Android API من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات Google Play". لن تتمكّن التطبيقات من إنشاء إصدارات إلى أن تتم إزالة تبعية واجهة برمجة التطبيقات Drive Android، ولكن لن تتأثّر الإصدارات الحالية. لن تكون المستندات المتاحة للجميع الخاصة بواجهة برمجة التطبيقات لنظام التشغيل Android في Drive متاحة بعد الآن.
|
| 3 آذار (مارس) 2022 |
تم إيقاف واجهة برمجة التطبيقات Drive Android API نهائيًا، وجميع طلبات البيانات من واجهة برمجة التطبيقات غير صالحة. يجب نقل البيانات بحلول هذا التاريخ.
|
| 1 فبراير 2023 |
سيتم إيقاف واجهة برمجة التطبيقات Drive Android API بالكامل، وستتعذّر جميع محاولات الاتصال.
|
استخدام Drive REST API
توفّر واجهة Drive REST API الوظائف نفسها التي توفّرها واجهة Drive Android API،
بما في ذلك طرق تنفيذ ما يلي:
لتسهيل جهود نقل التطبيقات، يتم توفير تطبيق نموذجي يوضّح كل البدائل المقترَحة أعلاه. توضّح هذه الصفحة أيضًا كيفية إنشاء ملفات Drive الخاصة بالمستخدم وتعديلها والبحث عنها باستخدام واجهة REST API. إذا واجهت أي مشاكل، يمكنك الاطّلاع على علامة google-drive-api على StackOverflow.
النقل
بما أنّ واجهة برمجة التطبيقات Drive Android API متوقّفة نهائيًا، وجميع طلبات البيانات من واجهة برمجة التطبيقات غير صالحة، تأكَّد من أنّ تطبيقك لم يعُد يطلب البيانات من واجهة برمجة التطبيقات. لإجراء ذلك، عليك إزالة الرمز الذي يبدأ واجهة برمجة التطبيقات: addApi(Drive.API).
إذا لم تنقل بياناتك من Drive Android API وحاول تطبيقك طلب البيانات من واجهة برمجة التطبيقات، ستظهر رسالة الخطأ التالية:
com.google.android.gms.common.api.ApiException: 17: API: Drive.API is not
available on this device. Connection failed with:
ConnectionResult{statusCode=API_UNAVAILABLE, resolution=null, message=null}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Migrate from the Google Drive Android API\n\n**The Drive Android API is deprecated as of December 6, 2018 and will be fully\nturned down on February 1, 2023**.\n\nTimeline\n--------\n\n| Date | Drive Android API status |\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| December 6, 2018 | Deprecation is [publicly announced](https://cloud.google.com/blog/products/application-development/sync-google-drive-files-to-apps-using-the-drive-rest-api-bidding-farewell-to-the-drive-android-api). Existing clients will be able to access the API normally, but should immediately commence with migration efforts. New clients must not use the API. |\n| October 21, 2019 | The Drive Android API is removed from the Google Play Services SDK distribution. Apps will be unable to build until removing the Drive Android API dependency, but existing builds will be unaffected. The Drive Android API public documentation will no longer be available. |\n| March 3, 2022 | The Drive Android API is deprecated and all API calls are non-operational. Clients must migrate by this date. |\n| February 1, 2023 | The Drive Android API will be fully turned down and all connection attempts will be unsuccessful. |\n\nUse the Drive REST API\n----------------------\n\nThe Drive REST API offers the same functionality as the Drive Android API,\nincluding ways to:\n\n- Share and collaborate as you expect from Drive. You can [manage permissions or prompt the Share dialog](/workspace/drive/api/guides/manage-sharing) to users as needed. The REST API also allows for commenting on files, allowing your app to interact with the conversation around a file.\n- Search for files using [`files.list`](/workspace/drive/api/v3/reference/files/list), based on traditional indexing or [your own customized, indexable text](/workspace/drive/api/guides/file).\n- Detect changes to files through the [Changes collection](/workspace/drive/api/v3/reference/changes) and to any shared with the user through [shared drives](/workspace/drive/api/guides/enable-shareddrives).\n- Export and convert Google Docs so that your app can easily [open a user's document](/workspace/drive/api/guides/integrate-open#specific).\n\nTo ease client migration efforts, a\n[sample app](https://github.com/googleworkspace/android-samples/tree/master/drive/deprecation) is provided which\ndemonstrates each of the proposed replacements above. It also shows how to\ncreate, modify, and query for a user's Drive files using the REST API. If you\nhave any issues, check out the\n[google-drive-api](https://stackoverflow.com/questions/tagged/google-drive-api?tab=Newest)\ntag on StackOverflow.\n\nMigration\n---------\n\nSince the Drive Android API is deprecated, and all API calls are\nnon-operational, make sure your app is no longer calling the API. To do this,\nremove the code that initializes the API: `addApi(Drive.API)`.\n\nIf you don't migrate from the Drive Android API, and your app attempts to call\nthe API, the following error message is returned:\n\n`com.google.android.gms.common.api.ApiException: 17: API: Drive.API is not\navailable on this device. Connection failed with:\nConnectionResult{statusCode=API_UNAVAILABLE, resolution=null, message=null}`"]]
