الوصول إلى ملفات 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 مفتاحًا واحدًا أو أكثر من مفاتيح الموارد باستخدام X-Goog-Drive-Resource-Keys رأس HTTP.

البنية

يتمّ ضبط معرّف الملف وزوج مفتاح المورد في العنوان باستخدام فاصل شرطة مائلة للأمام (/). يتم إنشاء العنوان من خلال دمج كل أزواج مفتاح المورد ورقم تعريف الملف باستخدام فواصل الفاصلة (,).

على سبيل المثال، لنفترض أنّه تم تقديم طلب لنقل الملف fileId1 من المجلد fileId2 إلى المجلد fileId3. لنفترض أنّ مفاتيح الموارد لهذه الملفات الثلاثة هي resourceKey1 وresourceKey2 وresourceKey3 على التوالي. العنوان المُنشئ من هذه القيم باستخدام الشرطة المائلة للأمام والفواصل هو:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3