Method: files.generateIds

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
count

integer

تعداد شناسنامه هایی که باید بازگردانده شوند.

space

string

فضایی که از شناسه ها می توان برای ایجاد فایل استفاده کرد. مقادیر پشتیبانی شده عبارتند از drive و appDataFolder . (پیش‌فرض: drive .) برای اطلاعات بیشتر، سازمان‌دهی فایل را ببینید.

type

string

نوع مواردی که شناسه ها می توانند برای آنها استفاده شوند. مقادیر پشتیبانی شده files و shortcuts هستند. توجه داشته باشید که shortcuts فقط در space drive پشتیبانی می شوند. (پیش‌فرض: files .) برای اطلاعات بیشتر، سازمان‌دهی فایل را ببینید.

درخواست بدن

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

بدن پاسخگو

لیستی از شناسه های فایل تولید شده که می توانند در درخواست های ایجاد ارائه شوند.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "ids": [
    string
  ],
  "space": string,
  "kind": string
}
فیلدها
ids[]

string

شناسه های ایجاد شده برای کاربر درخواست کننده در فضای مشخص شده.

space

string

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

kind

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "drive#generatedIds" .

محدوده مجوز

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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