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

نوع مواردی که شناسه ها می توانند برای آنها استفاده شوند. مقادیر پشتیبانی شده "فایل" و "میانبر" هستند. توجه داشته باشید که «میانبرها» فقط در «فضا» drive پشتیبانی می‌شوند. (پیش‌فرض: «فایل‌ها»)

درخواست بدن

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

بدن پاسخگو

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

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

نمایندگی 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

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