یک توکن CSE تولید میکند که میتواند برای ایجاد یا بهروزرسانی فایلهای CSE استفاده شود.
درخواست HTTP
GET https://www.googleapis.com/drive/v3/files/generateCseToken
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای پرس و جو
| پارامترها | |
|---|---|
fileId | شناسه فایلی که JWT باید برای آن تولید شود. در صورت عدم ارائه، یک شناسه تولید خواهد شد. |
parent | شناسهی والد مورد انتظار فایل. هنگام تولید JWT برای یک فایل CSE جدید استفاده میشود. در صورت مشخص شدن، والد واکشی میشود و اگر والد یک آیتم درایو مشترک باشد، از سیاست درایو مشترک برای تعیین KACLS مورد استفاده استفاده میشود. مشخص کردن همزمان fileId و parent در یک درخواست واحد نامعتبر است. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
JWT و متادیتای مرتبط که برای تولید فایلهای CSE استفاده میشوند.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "fileId": string, "currentKaclsId": string, "currentKaclsName": string, "jwt": string, "kind": string } |
| فیلدها | |
|---|---|
fileId | شناسه فایلی که JWT برای آن تولید شده است. |
currentKaclsId | شناسهی فعلی سرویس کلید ACL (KACLS) مرتبط با JWT. |
currentKaclsName | نام KACLهایی که شناسه KACLهای برگردانده شده به آنها اشاره میکند. |
jwt | توکن وب JSON امضا شده (JWT) برای فایل. |
kind | فقط خروجی. نوع منبع را مشخص میکند. مقدار: رشتهی ثابت |
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/docs -
https://www.googleapis.com/auth/drive
برخی از حوزهها محدود شدهاند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.