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

يمكنك مشاركة ملفات ومجلدات Google Drive مع مستخدمين آخرين باستخدام واجهة مستخدم Drive أو من خلال Google Drive API. عند المشاركة من Drive، يمكنك التحكّم في إمكانية تعديل المستخدمين للملف أو التعليق عليه أو فتحه فقط.

يساعد مفتاح المصدر في حماية ملفك من الوصول غير المقصود. مفاتيح المصادر هي مَعلمة إضافية يتم تمريرها ليتمكّن المستخدمون من الوصول إلى ملفات معيّنة تمت مشاركتها باستخدام رابط. على المستخدمين الذين لم يسبق لهم عرض الملف من قبل تقديم مفتاح المصدر للوصول إليه. أما المستخدمون الذين اطّلعوا على الملف مؤخرًا أو لديهم إذن وصول مباشر إليه، فلن يحتاجوا إلى مفتاح المصدر للوصول إلى الملف.

لا يمكن للمستخدمين الذين يمكنهم الوصول إلى ملف Drive نتيجةً لمصدر type=user أو type=group permissions العثور على ملف Drive تتم مشاركته باستخدام رابط. قد تتطلّب الطلبات من المستخدمين الذين يمكنهم الوصول إلى هذه الملفات التي تمت مشاركتها باستخدام رابط فقط من خلال إذن 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