يمكنك مشاركة ملفات ومجلدات 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
على عنوان 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