يمكنك مشاركة ملفات ومجلدات Google Drive مع الآخرين باستخدام واجهة مستخدم Drive أو من خلال Google Drive API. عند المشاركة من Drive، يمكنك التحكّم في إمكانية تعديل الآخرين للملف أو التعليق عليه أو فتحه فقط.
يساعد مفتاح المصدر في حماية ملفك من الوصول غير المقصود. مفاتيح الموارد هي معلمة إضافية يتم تمريرها حتى يتمكن المستخدمون من الوصول إلى ملفات معينة تمت مشاركتها باستخدام رابط. يجب على المستخدمين الذين لم يشاهدوا الملف من قبل تقديم مفتاح المورد للوصول إلى الملف. ولا يحتاج هؤلاء الذين شاهدوا الملف مؤخرًا، أو الذين لديهم إمكانية الوصول المباشر، إلى مفتاح المورد للوصول إلى الملف.
لا يمكن لأحد اكتشاف ملف Drive الذي تمت مشاركته باستخدام رابط إلا المستخدمين الذين يمكنهم الوصول إلى الملف نتيجة لمورد type=user
أو type=group
permissions
. إنّ طلبات المستخدمين الذين لديهم إذن بالوصول إلى هذه الملفات التي تمت مشاركتها باستخدام رابط فقط من خلال إذن type=domain
أو type=anyone
قد تتطلب مفتاح مورد.
لمزيد من المعلومات حول الأذونات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين السحابي. للحصول على قائمة كاملة بالأدوار والعمليات التي يسمح بها كل منها، يمكنك الاطّلاع على الأدوار والأذونات.
قراءة مفتاح المصدر من الملف
تعرض واجهة برمجة التطبيقات Drive API مفتاح مورد الملف في حقل resourceKey
للقراءة فقط في مورد files
.
إذا كان الملف عبارة عن اختصار Drive،
يتم عرض مفتاح المورد لهدف الاختصار في حقل shortcutDetails.targetResourceKey
للقراءة فقط.
في الحقول في المورد files
والتي تعرض عناوين URL،
مثل exportLinks
وwebContentLink
وwebViewLink
، تتضمّن أيضًا
resourceKey
. يمكن أيضًا للعملاء الذين يتكاملون مع واجهة مستخدم Drive
استخدام resourceKeys
ضمن
المَعلمة state
. لمزيد من المعلومات، راجع تنزيل الملفات وتصديرها.
ضبط مفتاح المصدر للطلب
تم ضبط مفاتيح الموارد لأي ملفات تتم الإشارة إليها من خلال الطلبات إلى واجهة برمجة تطبيقات Drive
على عنوان 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