Method: files.generateCseToken

تُنشئ هذه الطريقة رمزًا مميزًا للتشفير من جهة العميل يمكن استخدامه لإنشاء ملفات مشفَّرة من جهة العميل أو تعديلها.

طلب HTTP

GET https://www.googleapis.com/drive/v2/files/generateCseToken

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
fileId

string

رقم تعريف الملف الذي يجب إنشاء رمز JWT له في حال عدم توفيرها، سيتم إنشاء معرّف.
parent

string

رقم تعريف المجلد الرئيسي المتوقّع للملف يُستخدَم عند إنشاء رمز JWT لملف جديد مشفَّر من جهة العميل. في حال تحديدها، سيتم استرداد العنصر الأصل، وإذا كان العنصر الأصل هو عنصر في مساحة تخزين سحابي مشتركة، سيتم استخدام سياسة مساحة التخزين السحابي المشتركة لتحديد خدمة إدارة مفاتيح التشفير التي يجب استخدامها.

لا يمكن تحديد كلّ من fileId وparent في طلب واحد.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

يتم استخدام رمز JWT والبيانات الوصفية المرتبطة به لإنشاء ملفات "التشفير من جهة العميل".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "fileId": string,
  "currentKaclsId": string,
  "currentKaclsName": string,
  "jwt": string,
  "kind": string
}
الحقول
fileId

string

تمثّل هذه السمة رقم تعريف الملف الذي تم إنشاء رمز JWT له.
currentKaclsId

string (int64 format)

معرّف خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير (KACLS) الحالي المرتبط برمز JWT.
currentKaclsName

string

اسم قوائم التحكم بالوصول إلى مفاتيح التشفير التي يشير إليها رقم تعريف قوائم التحكم بالوصول إلى مفاتيح التشفير المعروضة.
jwt

string

رمز JSON المميّز للويب (JWT) المُوقّع للملف
kind

string

النتائج فقط. تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#generateCseTokenResponse".

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive

بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتطبيقك كي يتمكّن من استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.