این سرویس به اسکریپتها اجازه میدهد فایلها و پوشهها را در Google Drive ایجاد، پیدا و تغییر دهند.
اگر اسکریپت شما از یک پروژه استاندارد Cloud به جای پروژه پیشفرض Cloud استفاده میکند، باید به صورت دستی Drive API را روشن کنید. در پروژه استاندارد Cloud خود، Drive API را روشن کنید:
نمونه کد زیر نحوه ثبت نام هر فایل را در پوشه My Drive کاربر نشان می دهد:// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
کلاس ها
نام | شرح مختصر |
---|---|
Access | فهرستی که نشاندهنده دستههایی از کاربرانی است که میتوانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
Drive App | به اسکریپتها اجازه میدهد فایلها و پوشهها را در Google Drive ایجاد، پیدا و تغییر دهند. |
File | یک فایل در گوگل درایو. |
File Iterator | تکرارکننده ای که به اسکریپت ها اجازه می دهد تا روی مجموعه بزرگی از فایل ها تکرار شوند. |
Folder | پوشه ای در گوگل درایو |
Folder Iterator | یک شی که به اسکریپت ها اجازه می دهد تا روی مجموعه بزرگی از پوشه ها تکرار شوند. |
Permission | شماره ای که نشان دهنده مجوزهای اعطا شده به کاربرانی است که می توانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
User | کاربری مرتبط با یک فایل در Google Drive. |
Access
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
ANYONE | Enum | هر کسی در اینترنت می تواند پیدا کند و به آن دسترسی داشته باشد. |
ANYONE_WITH_LINK | Enum | هر کسی که پیوند را داشته باشد می تواند دسترسی داشته باشد. |
DOMAIN | Enum | افراد در دامنه شما می توانند پیدا کنند و به آن دسترسی داشته باشند. |
DOMAIN_WITH_LINK | Enum | افرادی در دامنه شما که پیوند را دارند می توانند دسترسی داشته باشند. |
PRIVATE | Enum | فقط افرادی که صراحتاً مجوز دارند می توانند دسترسی داشته باشند. |
Drive App
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
Access | Access | فهرستی که نشاندهنده دستههایی از کاربرانی است که میتوانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
Permission | Permission | شماره ای که نشان دهنده مجوزهای اعطا شده به کاربرانی است که می توانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
continue File Iterator(continuationToken) | File Iterator | تکرار یک فایل را با استفاده از یک نشانه ادامه از یک تکرار کننده قبلی از سر می گیرد. |
continue Folder Iterator(continuationToken) | Folder Iterator | تکرار یک پوشه را با استفاده از یک نشانه ادامه از یک تکرار کننده قبلی از سر می گیرد. |
create File(blob) | File | یک فایل در ریشه درایو کاربر از یک Blob داده دلخواه ایجاد می کند. |
create File(name, content) | File | یک فایل متنی در ریشه درایو کاربر با نام و محتوای داده شده ایجاد می کند. |
create File(name, content, mimeType) | File | فایلی با نام، محتویات و نوع MIME داده شده در ریشه درایو کاربر ایجاد می کند. |
create Folder(name) | Folder | پوشه ای در ریشه درایو کاربر با نام داده شده ایجاد می کند. |
create Shortcut(targetId) | File | یک میانبر برای شناسه مورد ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey) | File | یک میانبر برای شناسه مورد و کلید منبع ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
enforce Single Parent(value) | void | اعمال رفتار SingleParent را برای همه تماسهایی که والدین مورد را تحت تأثیر قرار میدهند، فعال یا غیرفعال میکند. |
get File By Id(id) | File | فایل را با شناسه داده شده دریافت می کند. |
get File By Id And Resource Key(id, resourceKey) | File | فایل را با شناسه و کلید منبع داده شده دریافت می کند. |
get Files() | File Iterator | مجموعه ای از تمام فایل ها را در Drive کاربر دریافت می کند. |
get Files By Name(name) | File Iterator | مجموعهای از تمام فایلهای درایو کاربر را دریافت میکند که این نام را دارند. |
get Files By Type(mimeType) | File Iterator | مجموعه ای از تمام فایل های درایو کاربر را دریافت می کند که دارای نوع MIME هستند. |
get Folder By Id(id) | Folder | پوشه با شناسه داده شده را دریافت می کند. |
get Folder By Id And Resource Key(id, resourceKey) | Folder | پوشه با شناسه و کلید منبع داده شده را دریافت می کند. |
get Folders() | Folder Iterator | مجموعه ای از تمام پوشه ها را در Drive کاربر دریافت می کند. |
get Folders By Name(name) | Folder Iterator | مجموعهای از تمام پوشههای درایو کاربر را که نام مشخص شده دارند، دریافت میکند. |
get Root Folder() | Folder | پوشه را در ریشه درایو کاربر دریافت می کند. |
get Storage Limit() | Integer | تعداد بایت هایی را که کاربر مجاز است در Drive ذخیره کند، دریافت می کند. |
get Storage Used() | Integer | تعداد بایت هایی را که کاربر در حال حاضر در Drive ذخیره می کند دریافت می کند. |
get Trashed Files() | File Iterator | مجموعه ای از تمام فایل های موجود در سطل زباله درایو کاربر را دریافت می کند. |
get Trashed Folders() | Folder Iterator | مجموعه ای از تمام پوشه های موجود در سطل زباله درایو کاربر را دریافت می کند. |
search Files(params) | File Iterator | مجموعه ای از همه فایل ها را در Drive کاربر دریافت می کند که با معیارهای جستجوی داده شده مطابقت دارند. |
search Folders(params) | Folder Iterator | مجموعه ای از تمام پوشه ها را در Drive کاربر دریافت می کند که با معیارهای جستجوی داده شده مطابقت دارند. |
File
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
add Commenter(emailAddress) | File | کاربر داده شده را به لیست نظر دهندگان File اضافه کنید. |
add Commenter(user) | File | کاربر داده شده را به لیست نظر دهندگان File اضافه کنید. |
add Commenters(emailAddresses) | File | آرایه داده شده از کاربران را به لیست نظر دهندگان File اضافه کنید. |
add Editor(emailAddress) | File | کاربر داده شده را به لیست ویرایشگرهای File اضافه می کند. |
add Editor(user) | File | کاربر داده شده را به لیست ویرایشگرهای File اضافه می کند. |
add Editors(emailAddresses) | File | آرایه داده شده از کاربران را به لیست ویرایشگرهای File اضافه می کند. |
add Viewer(emailAddress) | File | کاربر داده شده را به لیست بینندگان File اضافه می کند. |
add Viewer(user) | File | کاربر داده شده را به لیست بینندگان File اضافه می کند. |
add Viewers(emailAddresses) | File | آرایه داده شده از کاربران را به لیست بینندگان File اضافه می کند. |
get Access(email) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Access(user) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get As(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
get Blob() | Blob | داده های داخل این شی را به صورت حباب برگردانید. |
get Date Created() | Date | تاریخ ایجاد File را دریافت می کند. |
get Description() | String | توضیحات File را دریافت می کند. |
get Download Url() | String | آدرس اینترنتی را دریافت می کند که می توان از آن برای دانلود فایل استفاده کرد. |
get Editors() | User[] | لیست ویرایشگرهای این File را دریافت می کند. |
get Id() | String | شناسه File را می گیرد. |
get Last Updated() | Date | تاریخ آخرین به روز رسانی File دریافت می کند. |
get Mime Type() | String | نوع MIME فایل را دریافت می کند. |
get Name() | String | نام File را دریافت می کند. |
get Owner() | User | صاحب فایل را دریافت می کند. |
get Parents() | Folder Iterator | مجموعه ای از پوشه ها را دریافت می کند که والدین مستقیم File هستند. |
get Resource Key() | String | کلید منبع File را دریافت می کند که برای دسترسی به مواردی که با استفاده از پیوند به اشتراک گذاشته شده اند مورد نیاز است. |
get Security Update Eligible() | Boolean | دریافت که آیا این File واجد شرایط اعمال بهروزرسانی امنیتی است که برای دسترسی به آن نیاز به کلید منبع دارد یا خیر. |
get Security Update Enabled() | Boolean | دریافت می کند که آیا این File برای دسترسی به یک کلید منبع نیاز دارد یا خیر. |
get Sharing Access() | Access | مشخص می کند که چه دسته ای از کاربران می توانند به File دسترسی داشته باشند، علاوه بر هر کاربر فردی که به صراحت به آنها دسترسی داده شده است. |
get Sharing Permission() | Permission | به کاربرانی که میتوانند به File دسترسی داشته باشند، مجوز اعطا میکند، علاوه بر هر کاربر فردی که صریحاً به آنها دسترسی داده شده است. |
get Size() | Integer | تعداد بایت های مورد استفاده برای ذخیره File در Drive را دریافت می کند. |
get Target Id() | String | اگر این یک میانبر است، شناسه موردی را که به آن اشاره می کند برمی گرداند. |
get Target Mime Type() | String | اگر این یک میانبر است، نوع mime موردی را که به آن اشاره می کند برمی گرداند. |
get Target Resource Key() | String | اگر فایل یک میانبر باشد، کلید منبع موردی را که به آن اشاره می کند برمی گرداند. |
get Thumbnail() | Blob | یک تصویر بندانگشتی برای فایل دریافت میکند، یا اگر تصویر کوچکی وجود نداشته باشد، null . |
get Url() | String | نشانی اینترنتی را دریافت میکند که میتوان از آن برای باز کردن File در یک برنامه Google مانند Drive یا Docs استفاده کرد. |
get Viewers() | User[] | لیست بینندگان و نظر دهندگان این File را دریافت می کند. |
is Shareable By Editors() | Boolean | تعیین می کند که آیا کاربرانی که مجوز ویرایش File را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها هستند یا خیر. |
is Starred() | Boolean | تعیین می کند که آیا File در Drive کاربر ستاره گذاری شده است یا خیر. |
is Trashed() | Boolean | تعیین می کند که آیا File در سطل زباله درایو کاربر قرار دارد یا خیر. |
make Copy() | File | یک کپی از فایل ایجاد می کند. |
make Copy(destination) | File | یک کپی از فایل در فهرست مقصد ایجاد می کند. |
make Copy(name) | File | یک کپی از فایل ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند. |
make Copy(name, destination) | File | یک کپی از فایل در فهرست مقصد ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند. |
move To(destination) | File | این مورد را به پوشه مقصد ارائه شده منتقل می کند. |
remove Commenter(emailAddress) | File | کاربر داده شده را از لیست نظر دهندگان File حذف می کند. |
remove Commenter(user) | File | کاربر داده شده را از لیست نظر دهندگان File حذف می کند. |
remove Editor(emailAddress) | File | کاربر داده شده را از لیست ویرایشگرهای File حذف می کند. |
remove Editor(user) | File | کاربر داده شده را از لیست ویرایشگرهای File حذف می کند. |
remove Viewer(emailAddress) | File | کاربر داده شده را از لیست بینندگان و نظر دهندگان File حذف می کند. |
remove Viewer(user) | File | کاربر داده شده را از لیست بینندگان و نظر دهندگان File حذف می کند. |
revoke Permissions(emailAddress) | File | دسترسی به File که به کاربر داده شده داده شده را لغو می کند. |
revoke Permissions(user) | File | دسترسی به File که به کاربر داده شده داده شده را لغو می کند. |
set Content(content) | File | محتوای فایل را با یک جایگزین معین بازنویسی می کند. |
set Description(description) | File | توضیحات File را تنظیم می کند. |
set Name(name) | File | نام File را تنظیم می کند. |
set Owner(emailAddress) | File | مالک File را تغییر می دهد. |
set Owner(user) | File | Changes the owner of the File . |
set Security Update Enabled(enabled) | File | تعیین می کند که آیا File هنگام اشتراک گذاری با استفاده از پیوند، به کلید منبع برای دسترسی نیاز دارد یا خیر. |
set Shareable By Editors(shareable) | File | تعیین می کند که آیا کاربرانی که مجوزهای ویرایش File را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها باشند. |
set Sharing(accessType, permissionType) | File | تعیین می کند که کدام دسته از کاربران می توانند به File دسترسی داشته باشند و چه مجوزهایی به آن کاربران اعطا می شود، علاوه بر هر کاربر فردی که به طور صریح به آنها دسترسی داده شده است. |
set Starred(starred) | File | تعیین میکند که آیا File در Drive کاربر ستارهدار شود یا خیر. |
set Trashed(trashed) | File | تعیین می کند که آیا File در سطل زباله درایو کاربر قرار دارد یا خیر. |
File Iterator
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Continuation Token() | String | رمزی دریافت می کند که می تواند برای از سرگیری این تکرار در زمان دیگری استفاده شود. |
has Next() | Boolean | تعیین می کند که آیا فراخوانی next() یک آیتم را برمی گرداند یا خیر. |
next() | File | مورد بعدی را در مجموعه فایل ها یا پوشه ها دریافت می کند. |
Folder
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
add Editor(emailAddress) | Folder | کاربر داده شده را به لیست ویرایشگرهای Folder اضافه می کند. |
add Editor(user) | Folder | کاربر داده شده را به لیست ویرایشگرهای Folder اضافه می کند. |
add Editors(emailAddresses) | Folder | آرایه داده شده از کاربران را به لیست ویرایشگرهای Folder اضافه می کند. |
add Viewer(emailAddress) | Folder | کاربر داده شده را به لیست بینندگان Folder اضافه می کند. |
add Viewer(user) | Folder | کاربر داده شده را به لیست بینندگان Folder اضافه می کند. |
add Viewers(emailAddresses) | Folder | آرایه داده شده از کاربران را به لیست بینندگان Folder اضافه می کند. |
create File(blob) | File | یک فایل در پوشه فعلی از یک Blob داده دلخواه ایجاد می کند. |
create File(name, content) | File | یک فایل متنی در پوشه فعلی با نام و محتوای داده شده ایجاد می کند. |
create File(name, content, mimeType) | File | فایلی با نام، محتویات و نوع MIME در پوشه فعلی ایجاد می کند. |
create Folder(name) | Folder | یک پوشه در پوشه فعلی با نام داده شده ایجاد می کند. |
create Shortcut(targetId) | File | یک میانبر برای شناسه مورد ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey) | File | یک میانبر برای شناسه مورد و کلید منبع ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
get Access(email) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Access(user) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Date Created() | Date | تاریخ ایجاد Folder را دریافت می کند. |
get Description() | String | توضیحات مربوط به Folder را دریافت می کند. |
get Editors() | User[] | لیست ویرایشگرهای این Folder را دریافت می کند. |
get Files() | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند دریافت می کند. |
get Files By Name(name) | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند و نام مشخص شده دارند را دریافت می کند. |
get Files By Type(mimeType) | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند و دارای نوع MIME هستند دریافت می کند. |
get Folders() | Folder Iterator | مجموعه ای از تمام پوشه هایی را که فرزندان پوشه فعلی هستند دریافت می کند. |
get Folders By Name(name) | Folder Iterator | مجموعه ای از تمام پوشه هایی را که فرزندان پوشه فعلی هستند و نام مشخص شده دارند را دریافت می کند. |
get Id() | String | شناسه Folder را می گیرد. |
get Last Updated() | Date | تاریخ آخرین به روز رسانی Folder را دریافت می کند. |
get Name() | String | نام Folder را دریافت می کند. |
get Owner() | User | صاحب این Folder را می گیرد. |
get Parents() | Folder Iterator | مجموعه ای از پوشه ها را دریافت می کند که والدین فوری Folder هستند. |
get Resource Key() | String | کلید منبع Folder را که برای دسترسی به مواردی که با استفاده از پیوند به اشتراک گذاشته شده اند، مورد نیاز است. |
get Security Update Eligible() | Boolean | دریافت که آیا این Folder واجد شرایط اعمال بهروزرسانی امنیتی است که برای دسترسی به آن نیاز به کلید منبع دارد یا خیر. |
get Security Update Enabled() | Boolean | دریافت می کند که آیا این Folder برای دسترسی به یک کلید منبع نیاز دارد یا خیر. |
get Sharing Access() | Access | مشخص میکند که کدام دسته از کاربران میتوانند به Folder دسترسی داشته باشند، علاوه بر هر کاربر فردی که به صراحت به آنها دسترسی داده شده است. |
get Sharing Permission() | Permission | این مجوز را به آن دسته از کاربرانی که می توانند به Folder دسترسی داشته باشند، اعطا می کند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
get Size() | Integer | تعداد بایت های مورد استفاده برای ذخیره Folder در Drive را دریافت می کند. |
get Url() | String | نشانی اینترنتی را دریافت می کند که می تواند برای باز کردن Folder در برنامه Google مانند Drive یا Docs استفاده شود. |
get Viewers() | User[] | لیست بینندگان و نظر دهندگان را برای این Folder دریافت می کند. |
is Shareable By Editors() | Boolean | تعیین می کند که آیا کاربرانی که مجوزهای ویرایش Folder را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها هستند یا خیر. |
is Starred() | Boolean | تعیین می کند که آیا Folder در Drive کاربر ستاره گذاری شده است یا خیر. |
is Trashed() | Boolean | تعیین می کند که آیا Folder در سطل زباله درایو کاربر قرار دارد یا خیر. |
move To(destination) | Folder | این مورد را به پوشه مقصد ارائه شده منتقل می کند. |
remove Editor(emailAddress) | Folder | کاربر داده شده را از لیست ویرایشگرهای Folder حذف می کند. |
remove Editor(user) | Folder | کاربر داده شده را از لیست ویرایشگرهای Folder حذف می کند. |
remove Viewer(emailAddress) | Folder | کاربر داده شده را از لیست بینندگان و نظردهندگان Folder حذف می کند. |
remove Viewer(user) | Folder | کاربر داده شده را از لیست بینندگان و نظردهندگان Folder حذف می کند. |
revoke Permissions(emailAddress) | Folder | دسترسی به Folder که به کاربر داده شده داده شده را لغو می کند. |
revoke Permissions(user) | Folder | دسترسی به Folder که به کاربر داده شده داده شده را لغو می کند. |
search Files(params) | File Iterator | مجموعهای از تمام فایلهایی را دریافت میکند که فرزندان پوشه فعلی هستند و با معیارهای جستجوی داده شده مطابقت دارند. |
search Folders(params) | Folder Iterator | مجموعهای از تمام پوشههایی را دریافت میکند که فرزندان پوشه فعلی هستند و با معیارهای جستجوی داده شده مطابقت دارند. |
set Description(description) | Folder | توضیحات را برای Folder تنظیم می کند. |
set Name(name) | Folder | نام Folder را تنظیم می کند. |
set Owner(emailAddress) | Folder | مالک Folder را تغییر می دهد. |
set Owner(user) | Folder | مالک Folder را تغییر می دهد. |
set Security Update Enabled(enabled) | Folder | تنظیم می کند که آیا Folder برای دسترسی به کلید منبع در هنگام اشتراک گذاری با استفاده از پیوند نیاز دارد یا خیر. |
set Shareable By Editors(shareable) | Folder | تعیین می کند که آیا کاربرانی که مجوز ویرایش در Folder را دارند، مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها باشند. |
set Sharing(accessType, permissionType) | Folder | تعیین می کند که کدام دسته از کاربران می توانند به Folder دسترسی داشته باشند و چه مجوزهایی به آن کاربران داده می شود، علاوه بر هر کاربر فردی که به طور صریح به آنها دسترسی داده شده است. |
set Starred(starred) | Folder | تعیین میکند که Folder در Drive کاربر ستارهدار شود یا خیر. |
set Trashed(trashed) | Folder | تعیین می کند که آیا Folder در سطل زباله درایو کاربر باشد. |
Folder Iterator
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Continuation Token() | String | رمزی دریافت می کند که می تواند برای از سرگیری این تکرار در زمان دیگری استفاده شود. |
has Next() | Boolean | تعیین می کند که آیا فراخوانی next() یک آیتم را برمی گرداند یا خیر. |
next() | Folder | مورد بعدی را در مجموعه فایل ها یا پوشه ها دریافت می کند. |
Permission
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
VIEW | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند فقط می توانند آن را مشاهده یا کپی کنند. |
EDIT | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند می توانند آن را ویرایش کنند. |
COMMENT | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند فقط می توانند آن را مشاهده کنند، آن را کپی کنند یا روی آن نظر بدهند. |
OWNER | Enum | کاربر مالک فایل یا پوشه است. |
ORGANIZER | Enum | کاربرانی که می توانند فایل ها و پوشه ها را در یک درایو مشترک سازماندهی کنند. |
FILE_ORGANIZER | Enum | کاربرانی که می توانند محتوا را در یک درایو مشترک ویرایش، حذف و انتقال دهند. |
NONE | Enum | کاربر هیچ مجوزی برای فایل یا پوشه ندارد. |
User
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Domain() | String | نام دامنه مرتبط با حساب کاربر را دریافت می کند. |
get Email() | String | آدرس ایمیل کاربر را دریافت می کند. |
get Name() | String | نام کاربر را دریافت می کند. |
get Photo Url() | String | نشانی اینترنتی عکس کاربر را دریافت می کند. |
این سرویس به اسکریپتها اجازه میدهد فایلها و پوشهها را در Google Drive ایجاد، پیدا و تغییر دهند.
اگر اسکریپت شما از یک پروژه استاندارد Cloud به جای پروژه پیشفرض Cloud استفاده میکند، باید به صورت دستی Drive API را روشن کنید. در پروژه استاندارد Cloud خود، Drive API را روشن کنید:
نمونه کد زیر نحوه ثبت نام هر فایل را در پوشه My Drive کاربر نشان می دهد:// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
کلاس ها
نام | شرح مختصر |
---|---|
Access | فهرستی که نشاندهنده دستههایی از کاربرانی است که میتوانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
Drive App | به اسکریپتها اجازه میدهد فایلها و پوشهها را در Google Drive ایجاد، پیدا و تغییر دهند. |
File | یک فایل در گوگل درایو. |
File Iterator | تکرارکننده ای که به اسکریپت ها اجازه می دهد تا روی مجموعه بزرگی از فایل ها تکرار شوند. |
Folder | پوشه ای در گوگل درایو |
Folder Iterator | یک شی که به اسکریپت ها اجازه می دهد تا روی مجموعه بزرگی از پوشه ها تکرار شوند. |
Permission | شماره ای که نشان دهنده مجوزهای اعطا شده به کاربرانی است که می توانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
User | کاربری مرتبط با یک فایل در Google Drive. |
Access
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
ANYONE | Enum | هر کسی در اینترنت می تواند پیدا کند و به آن دسترسی داشته باشد. |
ANYONE_WITH_LINK | Enum | هر کسی که پیوند را داشته باشد می تواند دسترسی داشته باشد. |
DOMAIN | Enum | افراد در دامنه شما می توانند پیدا کنند و به آن دسترسی داشته باشند. |
DOMAIN_WITH_LINK | Enum | افرادی در دامنه شما که پیوند را دارند می توانند دسترسی داشته باشند. |
PRIVATE | Enum | فقط افرادی که صراحتاً مجوز دارند می توانند دسترسی داشته باشند. |
Drive App
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
Access | Access | فهرستی که نشاندهنده دستههایی از کاربرانی است که میتوانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
Permission | Permission | شماره ای که نشان دهنده مجوزهای اعطا شده به کاربرانی است که می توانند به یک فایل یا پوشه دسترسی داشته باشند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
continue File Iterator(continuationToken) | File Iterator | تکرار یک فایل را با استفاده از یک نشانه ادامه از یک تکرار کننده قبلی از سر می گیرد. |
continue Folder Iterator(continuationToken) | Folder Iterator | تکرار یک پوشه را با استفاده از یک نشانه ادامه از یک تکرار کننده قبلی از سر می گیرد. |
create File(blob) | File | یک فایل در ریشه درایو کاربر از یک Blob داده دلخواه ایجاد می کند. |
create File(name, content) | File | یک فایل متنی در ریشه درایو کاربر با نام و محتوای داده شده ایجاد می کند. |
create File(name, content, mimeType) | File | فایلی با نام، محتویات و نوع MIME داده شده در ریشه درایو کاربر ایجاد می کند. |
create Folder(name) | Folder | پوشه ای در ریشه درایو کاربر با نام داده شده ایجاد می کند. |
create Shortcut(targetId) | File | یک میانبر برای شناسه مورد ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey) | File | یک میانبر برای شناسه مورد و کلید منبع ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
enforce Single Parent(value) | void | اعمال رفتار SingleParent را برای همه تماسهایی که والدین مورد را تحت تأثیر قرار میدهند، فعال یا غیرفعال میکند. |
get File By Id(id) | File | فایل را با شناسه داده شده دریافت می کند. |
get File By Id And Resource Key(id, resourceKey) | File | فایل را با شناسه و کلید منبع داده شده دریافت می کند. |
get Files() | File Iterator | مجموعه ای از تمام فایل ها را در Drive کاربر دریافت می کند. |
get Files By Name(name) | File Iterator | مجموعهای از تمام فایلهای درایو کاربر را دریافت میکند که این نام را دارند. |
get Files By Type(mimeType) | File Iterator | مجموعه ای از تمام فایل های درایو کاربر را دریافت می کند که دارای نوع MIME هستند. |
get Folder By Id(id) | Folder | پوشه با شناسه داده شده را دریافت می کند. |
get Folder By Id And Resource Key(id, resourceKey) | Folder | پوشه با شناسه و کلید منبع داده شده را دریافت می کند. |
get Folders() | Folder Iterator | مجموعه ای از تمام پوشه ها را در Drive کاربر دریافت می کند. |
get Folders By Name(name) | Folder Iterator | مجموعهای از تمام پوشههای درایو کاربر را که نام مشخص شده دارند، دریافت میکند. |
get Root Folder() | Folder | پوشه را در ریشه درایو کاربر دریافت می کند. |
get Storage Limit() | Integer | تعداد بایت هایی را که کاربر مجاز است در Drive ذخیره کند، دریافت می کند. |
get Storage Used() | Integer | تعداد بایت هایی را که کاربر در حال حاضر در Drive ذخیره می کند دریافت می کند. |
get Trashed Files() | File Iterator | مجموعه ای از تمام فایل های موجود در سطل زباله درایو کاربر را دریافت می کند. |
get Trashed Folders() | Folder Iterator | مجموعه ای از تمام پوشه های موجود در سطل زباله درایو کاربر را دریافت می کند. |
search Files(params) | File Iterator | مجموعه ای از همه فایل ها را در Drive کاربر دریافت می کند که با معیارهای جستجوی داده شده مطابقت دارند. |
search Folders(params) | Folder Iterator | مجموعه ای از تمام پوشه ها را در Drive کاربر دریافت می کند که با معیارهای جستجوی داده شده مطابقت دارند. |
File
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
add Commenter(emailAddress) | File | کاربر داده شده را به لیست نظر دهندگان File اضافه کنید. |
add Commenter(user) | File | کاربر داده شده را به لیست نظر دهندگان File اضافه کنید. |
add Commenters(emailAddresses) | File | آرایه داده شده از کاربران را به لیست نظر دهندگان File اضافه کنید. |
add Editor(emailAddress) | File | کاربر داده شده را به لیست ویرایشگرهای File اضافه می کند. |
add Editor(user) | File | کاربر داده شده را به لیست ویرایشگرهای File اضافه می کند. |
add Editors(emailAddresses) | File | آرایه داده شده از کاربران را به لیست ویرایشگرهای File اضافه می کند. |
add Viewer(emailAddress) | File | کاربر داده شده را به لیست بینندگان File اضافه می کند. |
add Viewer(user) | File | کاربر داده شده را به لیست بینندگان File اضافه می کند. |
add Viewers(emailAddresses) | File | آرایه داده شده از کاربران را به لیست بینندگان File اضافه می کند. |
get Access(email) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Access(user) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get As(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
get Blob() | Blob | داده های داخل این شی را به صورت حباب برگردانید. |
get Date Created() | Date | تاریخ ایجاد File را دریافت می کند. |
get Description() | String | توضیحات File را دریافت می کند. |
get Download Url() | String | آدرس اینترنتی را دریافت می کند که می توان از آن برای دانلود فایل استفاده کرد. |
get Editors() | User[] | لیست ویرایشگرهای این File را دریافت می کند. |
get Id() | String | شناسه File را می گیرد. |
get Last Updated() | Date | Gets the date the File was last updated. |
get Mime Type() | String | نوع MIME فایل را دریافت می کند. |
get Name() | String | نام File را دریافت می کند. |
get Owner() | User | صاحب فایل را دریافت می کند. |
get Parents() | Folder Iterator | مجموعه ای از پوشه ها را دریافت می کند که والدین مستقیم File هستند. |
get Resource Key() | String | کلید منبع File را دریافت می کند که برای دسترسی به مواردی که با استفاده از پیوند به اشتراک گذاشته شده اند مورد نیاز است. |
get Security Update Eligible() | Boolean | دریافت که آیا این File واجد شرایط اعمال بهروزرسانی امنیتی است که برای دسترسی به آن نیاز به کلید منبع دارد یا خیر. |
get Security Update Enabled() | Boolean | دریافت می کند که آیا این File برای دسترسی به یک کلید منبع نیاز دارد یا خیر. |
get Sharing Access() | Access | مشخص می کند که چه دسته ای از کاربران می توانند به File دسترسی داشته باشند، علاوه بر هر کاربر فردی که به صراحت به آنها دسترسی داده شده است. |
get Sharing Permission() | Permission | به کاربرانی که میتوانند به File دسترسی داشته باشند، مجوز اعطا میکند، علاوه بر هر کاربر فردی که صریحاً به آنها دسترسی داده شده است. |
get Size() | Integer | تعداد بایت های مورد استفاده برای ذخیره File در Drive را دریافت می کند. |
get Target Id() | String | اگر این یک میانبر است، شناسه موردی را که به آن اشاره می کند برمی گرداند. |
get Target Mime Type() | String | اگر این یک میانبر است، نوع mime موردی را که به آن اشاره می کند برمی گرداند. |
get Target Resource Key() | String | اگر فایل یک میانبر باشد، کلید منبع موردی را که به آن اشاره می کند برمی گرداند. |
get Thumbnail() | Blob | یک تصویر بندانگشتی برای فایل دریافت میکند، یا اگر تصویر کوچکی وجود نداشته باشد null . |
get Url() | String | نشانی اینترنتی را دریافت میکند که میتوان از آن برای باز کردن File در یک برنامه Google مانند Drive یا Docs استفاده کرد. |
get Viewers() | User[] | لیست بینندگان و نظر دهندگان این File را دریافت می کند. |
is Shareable By Editors() | Boolean | تعیین می کند که آیا کاربرانی که مجوز ویرایش File را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها هستند یا خیر. |
is Starred() | Boolean | تعیین می کند که آیا File در Drive کاربر ستاره گذاری شده است یا خیر. |
is Trashed() | Boolean | تعیین می کند که آیا File در سطل زباله درایو کاربر قرار دارد یا خیر. |
make Copy() | File | یک کپی از فایل ایجاد می کند. |
make Copy(destination) | File | یک کپی از فایل در فهرست مقصد ایجاد می کند. |
make Copy(name) | File | یک کپی از فایل ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند. |
make Copy(name, destination) | File | یک کپی از فایل در فهرست مقصد ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند. |
move To(destination) | File | این مورد را به پوشه مقصد ارائه شده منتقل می کند. |
remove Commenter(emailAddress) | File | کاربر داده شده را از لیست نظر دهندگان File حذف می کند. |
remove Commenter(user) | File | کاربر داده شده را از لیست نظر دهندگان File حذف می کند. |
remove Editor(emailAddress) | File | کاربر داده شده را از لیست ویرایشگرهای File حذف می کند. |
remove Editor(user) | File | کاربر داده شده را از لیست ویرایشگرهای File حذف می کند. |
remove Viewer(emailAddress) | File | کاربر داده شده را از لیست بینندگان و نظر دهندگان File حذف می کند. |
remove Viewer(user) | File | کاربر داده شده را از لیست بینندگان و نظر دهندگان File حذف می کند. |
revoke Permissions(emailAddress) | File | دسترسی به File که به کاربر داده شده داده شده را لغو می کند. |
revoke Permissions(user) | File | دسترسی به File که به کاربر داده شده داده شده را لغو می کند. |
set Content(content) | File | محتوای فایل را با یک جایگزین معین بازنویسی می کند. |
set Description(description) | File | توضیحات File را تنظیم می کند. |
set Name(name) | File | نام File را تنظیم می کند. |
set Owner(emailAddress) | File | مالک File را تغییر می دهد. |
set Owner(user) | File | مالک File را تغییر می دهد. |
set Security Update Enabled(enabled) | File | تعیین می کند که آیا File هنگام اشتراک گذاری با استفاده از پیوند، به کلید منبع برای دسترسی نیاز دارد یا خیر. |
set Shareable By Editors(shareable) | File | تعیین می کند که آیا کاربرانی که مجوزهای ویرایش File را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها باشند. |
set Sharing(accessType, permissionType) | File | تعیین می کند که کدام دسته از کاربران می توانند به File دسترسی داشته باشند و چه مجوزهایی به آن کاربران اعطا می شود، علاوه بر هر کاربر فردی که به طور صریح به آنها دسترسی داده شده است. |
set Starred(starred) | File | تعیین میکند که آیا File در Drive کاربر ستارهدار شود یا خیر. |
set Trashed(trashed) | File | تعیین می کند که آیا File در سطل زباله درایو کاربر قرار دارد یا خیر. |
File Iterator
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Continuation Token() | String | رمزی دریافت می کند که می تواند برای از سرگیری این تکرار در زمان دیگری استفاده شود. |
has Next() | Boolean | تعیین می کند که آیا فراخوانی next() یک آیتم را برمی گرداند یا خیر. |
next() | File | مورد بعدی را در مجموعه فایل ها یا پوشه ها دریافت می کند. |
Folder
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
add Editor(emailAddress) | Folder | کاربر داده شده را به لیست ویرایشگرهای Folder اضافه می کند. |
add Editor(user) | Folder | کاربر داده شده را به لیست ویرایشگرهای Folder اضافه می کند. |
add Editors(emailAddresses) | Folder | آرایه داده شده از کاربران را به لیست ویرایشگرهای Folder اضافه می کند. |
add Viewer(emailAddress) | Folder | کاربر داده شده را به لیست بینندگان Folder اضافه می کند. |
add Viewer(user) | Folder | کاربر داده شده را به لیست بینندگان Folder اضافه می کند. |
add Viewers(emailAddresses) | Folder | آرایه داده شده از کاربران را به لیست بینندگان Folder اضافه می کند. |
create File(blob) | File | یک فایل در پوشه فعلی از یک Blob داده دلخواه ایجاد می کند. |
create File(name, content) | File | یک فایل متنی در پوشه فعلی با نام و محتوای داده شده ایجاد می کند. |
create File(name, content, mimeType) | File | فایلی با نام، محتویات و نوع MIME در پوشه فعلی ایجاد می کند. |
create Folder(name) | Folder | یک پوشه در پوشه فعلی با نام داده شده ایجاد می کند. |
create Shortcut(targetId) | File | یک میانبر برای شناسه مورد ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey) | File | یک میانبر برای شناسه مورد و کلید منبع ارائه شده Drive ایجاد می کند و آن را برمی گرداند. |
get Access(email) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Access(user) | Permission | مجوز اعطا شده به یک کاربر خاص را دریافت می کند. |
get Date Created() | Date | تاریخ ایجاد Folder را دریافت می کند. |
get Description() | String | توضیحات مربوط به Folder را دریافت می کند. |
get Editors() | User[] | لیست ویرایشگرهای این Folder را دریافت می کند. |
get Files() | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند دریافت می کند. |
get Files By Name(name) | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند و نام مشخص شده دارند را دریافت می کند. |
get Files By Type(mimeType) | File Iterator | مجموعه ای از تمام فایل هایی را که فرزندان پوشه فعلی هستند و دارای نوع MIME هستند دریافت می کند. |
get Folders() | Folder Iterator | مجموعه ای از تمام پوشه هایی را که فرزندان پوشه فعلی هستند دریافت می کند. |
get Folders By Name(name) | Folder Iterator | مجموعه ای از تمام پوشه هایی را که فرزندان پوشه فعلی هستند و نام مشخص شده دارند را دریافت می کند. |
get Id() | String | شناسه Folder را می گیرد. |
get Last Updated() | Date | تاریخ آخرین به روز رسانی Folder را دریافت می کند. |
get Name() | String | نام Folder را دریافت می کند. |
get Owner() | User | صاحب این Folder را می گیرد. |
get Parents() | Folder Iterator | مجموعه ای از پوشه ها را دریافت می کند که والدین فوری Folder هستند. |
get Resource Key() | String | کلید منبع Folder را که برای دسترسی به مواردی که با استفاده از پیوند به اشتراک گذاشته شده اند، مورد نیاز است. |
get Security Update Eligible() | Boolean | دریافت که آیا این Folder واجد شرایط اعمال بهروزرسانی امنیتی است که برای دسترسی به آن نیاز به کلید منبع دارد یا خیر. |
get Security Update Enabled() | Boolean | دریافت می کند که آیا این Folder برای دسترسی به یک کلید منبع نیاز دارد یا خیر. |
get Sharing Access() | Access | مشخص میکند که کدام دسته از کاربران میتوانند به Folder دسترسی داشته باشند، علاوه بر هر کاربر فردی که به صراحت به آنها دسترسی داده شده است. |
get Sharing Permission() | Permission | این مجوز را به آن دسته از کاربرانی که می توانند به Folder دسترسی داشته باشند، اعطا می کند، علاوه بر هر کاربر فردی که صراحتاً به آنها دسترسی داده شده است. |
get Size() | Integer | تعداد بایت های مورد استفاده برای ذخیره Folder در Drive را دریافت می کند. |
get Url() | String | نشانی اینترنتی را دریافت می کند که می تواند برای باز کردن Folder در برنامه Google مانند Drive یا Docs استفاده شود. |
get Viewers() | User[] | لیست بینندگان و نظر دهندگان را برای این Folder دریافت می کند. |
is Shareable By Editors() | Boolean | تعیین می کند که آیا کاربرانی که مجوزهای ویرایش Folder را دارند مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها هستند یا خیر. |
is Starred() | Boolean | تعیین می کند که آیا Folder در Drive کاربر ستاره گذاری شده است یا خیر. |
is Trashed() | Boolean | تعیین می کند که آیا Folder در سطل زباله درایو کاربر قرار دارد یا خیر. |
move To(destination) | Folder | این مورد را به پوشه مقصد ارائه شده منتقل می کند. |
remove Editor(emailAddress) | Folder | کاربر داده شده را از لیست ویرایشگرهای Folder حذف می کند. |
remove Editor(user) | Folder | کاربر داده شده را از لیست ویرایشگرهای Folder حذف می کند. |
remove Viewer(emailAddress) | Folder | کاربر داده شده را از لیست بینندگان و نظردهندگان Folder حذف می کند. |
remove Viewer(user) | Folder | کاربر داده شده را از لیست بینندگان و نظردهندگان Folder حذف می کند. |
revoke Permissions(emailAddress) | Folder | دسترسی به Folder که به کاربر داده شده داده شده را لغو می کند. |
revoke Permissions(user) | Folder | دسترسی به Folder که به کاربر داده شده داده شده را لغو می کند. |
search Files(params) | File Iterator | مجموعهای از تمام فایلهایی را دریافت میکند که فرزندان پوشه فعلی هستند و با معیارهای جستجوی داده شده مطابقت دارند. |
search Folders(params) | Folder Iterator | مجموعهای از تمام پوشههایی را دریافت میکند که فرزندان پوشه فعلی هستند و با معیارهای جستجوی داده شده مطابقت دارند. |
set Description(description) | Folder | توضیحات را برای Folder تنظیم می کند. |
set Name(name) | Folder | نام Folder را تنظیم می کند. |
set Owner(emailAddress) | Folder | Changes the owner of the Folder . |
set Owner(user) | Folder | مالک Folder را تغییر می دهد. |
set Security Update Enabled(enabled) | Folder | تنظیم می کند که آیا Folder برای دسترسی به کلید منبع در هنگام اشتراک گذاری با استفاده از پیوند نیاز دارد یا خیر. |
set Shareable By Editors(shareable) | Folder | تعیین می کند که آیا کاربرانی که مجوز ویرایش در Folder را دارند، مجاز به اشتراک گذاری با سایر کاربران یا تغییر مجوزها باشند. |
set Sharing(accessType, permissionType) | Folder | تعیین می کند که کدام دسته از کاربران می توانند به Folder دسترسی داشته باشند و چه مجوزهایی به آن کاربران داده می شود، علاوه بر هر کاربر فردی که به طور صریح به آنها دسترسی داده شده است. |
set Starred(starred) | Folder | تعیین میکند که Folder در Drive کاربر ستارهدار شود یا خیر. |
set Trashed(trashed) | Folder | تعیین می کند که آیا Folder در سطل زباله درایو کاربر باشد. |
Folder Iterator
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Continuation Token() | String | رمزی دریافت می کند که می تواند برای از سرگیری این تکرار در زمان دیگری استفاده شود. |
has Next() | Boolean | تعیین می کند که آیا فراخوانی next() یک آیتم را برمی گرداند یا خیر. |
next() | Folder | مورد بعدی را در مجموعه فایل ها یا پوشه ها دریافت می کند. |
Permission
خواص
اموال | تایپ کنید | توضیحات |
---|---|---|
VIEW | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند فقط می توانند آن را مشاهده یا کپی کنند. |
EDIT | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند می توانند آن را ویرایش کنند. |
COMMENT | Enum | کاربرانی که می توانند به فایل یا پوشه دسترسی داشته باشند فقط می توانند آن را مشاهده کنند، آن را کپی کنند یا روی آن نظر بدهند. |
OWNER | Enum | کاربر مالک فایل یا پوشه است. |
ORGANIZER | Enum | کاربرانی که می توانند فایل ها و پوشه ها را در یک درایو مشترک سازماندهی کنند. |
FILE_ORGANIZER | Enum | کاربرانی که می توانند محتوا را در یک درایو مشترک ویرایش، حذف و انتقال دهند. |
NONE | Enum | کاربر هیچ مجوزی برای فایل یا پوشه ندارد. |
User
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
get Domain() | String | نام دامنه مرتبط با حساب کاربر را دریافت می کند. |
get Email() | String | آدرس ایمیل کاربر را دریافت می کند. |
get Name() | String | نام کاربر را دریافت می کند. |
get Photo Url() | String | نشانی اینترنتی عکس کاربر را دریافت می کند. |