يمكنك مشاركة ملفات ومجلدات Google Drive مع الآخرين باستخدام واجهة مستخدم Drive أو من خلال Google Drive API: عند المشاركة من في Drive، يمكنك تحديد ما إذا كان بإمكان المستخدمين تعديل الملف أو التعليق عليه فتح الملف فقط.
يساعد مفتاح المصدر في حماية ملفك من الوصول غير المقصود. مفاتيح الموارد هي معلَمة إضافية يتم تمريرها حتى يتمكن المستخدمون من الوصول إلى ملفات معينة التي تمت مشاركتها باستخدام رابط. المستخدمون الذين لم يشاهدوا الملف من قبل يجب تقديم مفتاح المصدر للحصول على إمكانية الوصول. إنّ الأشخاص الذين شاهدوا مؤخرًا أو لديهم حق الوصول المباشر، لا يحتاجون إلى مفتاح المورد للوصول إلى الملف.
لا يمكن اكتشاف ملف Drive الذي تمت مشاركته باستخدام رابط إلا عن طريق
المستخدمون الذين يمكنهم الوصول إلى الملف كنتيجة لـ type=user
أو type=group
المرجع permissions
طلبات المستخدمين
التي لديها إمكانية الدخول إلى هذه الملفات المشتركة باستخدام رابط فقط باستخدام type=domain
أو
قد يتطلب إذن type=anyone
مفتاح مصدر.
لمزيد من المعلومات حول الأذونات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين السحابي. للحصول على قائمة كاملة بالأدوار والعمليات المسموح بها من قِبل كلٍ منهما، راجع الأدوار الأذونات.
قراءة مفتاح المصدر من الملف
تعرض واجهة برمجة تطبيقات Drive مفتاح مورد الملف في وضع القراءة فقط
الحقل resourceKey
في المورد files
.
إذا كان الملف عبارة عن اختصار في Drive،
مفتاح المصدر لهدف الاختصار في واجهة القراءة فقط
الحقل "shortcutDetails.targetResourceKey
".
الحقول في مورد files
التي تعرض عناوين URL،
مثل exportLinks
وwebContentLink
وwebViewLink
، تضم أيضًا
resourceKey
يمكن للعملاء الذين يتكاملون مع واجهة مستخدم Drive أيضًا
استخدام resourceKeys
ضمن state
. لمزيد من المعلومات، يُرجى الاطّلاع على التنزيل والتصدير
الملفات.
ضبط مفتاح المصدر في الطلب
مفاتيح الموارد لأي ملفات تتم الإشارة إليها من خلال الطلبات إلى Drive API
يتم ضبطها على عنوان HTTP الذي يتضمّن X-Goog-Drive-Resource-Keys
.
يمكن أن تحدّد الطلبات إلى واجهة برمجة التطبيقات Drive API مفتاحًا واحدًا أو أكثر من مفاتيح المصدر باستخدام
عنوان HTTP يتضمّن العنصر X-Goog-Drive-Resource-Keys
.
البنية
يتم ضبط معرّف الملف ومفتاحَي المصدر على العنوان باستخدام شرطة مائلة للأمام.
(/
). يتم إنشاء العنوان من خلال الجمع بين كل معرف الملف والمورد
أزواج المفاتيح باستخدام فواصل (,
).
على سبيل المثال، يمكنك طلب نقل الملف "fileId1
" من المجلد "fileId2
" إلى
المجلد fileId3
. افترض أن مفاتيح الموارد لهذه الملفات الثلاثة
resourceKey1
وresourceKey2
وresourceKey3
على التوالي. العنوان
التي يتم إنشاؤها من هذه القيم باستخدام شرطة مائلة للأمام وفواصل بين القيم هي:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
مواضيع ذات صلة
- مشاركة الملفات والمجلدات ومساحات التخزين السحابي
- تنزيل الملفات وتصديرها
- حماية محتوى الملف
- إعداد دمج واجهة مستخدم Drive