الوصول إلى ملفات Drive المشتركة باستخدام روابط باستخدام مفاتيح الموارد

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