Method: files.generateCseToken

یک توکن CSE تولید می‌کند که می‌تواند برای ایجاد یا به‌روزرسانی فایل‌های CSE استفاده شود.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
fileId

string

شناسه فایلی که JWT باید برای آن تولید شود. در صورت عدم ارائه، یک شناسه تولید خواهد شد.

parent

string

شناسه‌ی والد مورد انتظار فایل. هنگام تولید JWT برای یک فایل CSE جدید استفاده می‌شود. در صورت مشخص شدن، والد واکشی می‌شود و اگر والد یک آیتم درایو مشترک باشد، از سیاست درایو مشترک برای تعیین KACLS مورد استفاده استفاده می‌شود.

مشخص کردن همزمان fileId و parent در یک درخواست واحد نامعتبر است.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

JWT و متادیتای مرتبط که برای تولید فایل‌های CSE استفاده می‌شوند.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON
{
  "fileId": string,
  "currentKaclsId": string,
  "currentKaclsName": string,
  "jwt": string,
  "kind": string
}
فیلدها
fileId

string

شناسه فایلی که JWT برای آن تولید شده است.

currentKaclsId

string ( int64 format)

شناسه‌ی فعلی سرویس کلید ACL (KACLS) مرتبط با JWT.

currentKaclsName

string

نام KACLهایی که شناسه KACLهای برگردانده شده به آنها اشاره می‌کند.

jwt

string

توکن وب JSON امضا شده (JWT) برای فایل.

kind

string

فقط خروجی. نوع منبع را مشخص می‌کند. مقدار: رشته‌ی ثابت "drive#generateCseTokenResponse" .

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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

برخی از حوزه‌ها محدود شده‌اند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.