الوصول إلى ملفات 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 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