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