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

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