یک فایل در گوگل درایو. فایل ها را می توان از Drive App
دسترسی یا ایجاد کرد.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
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 | مالک 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 در سطل زباله درایو کاربر قرار دارد یا خیر. |
مستندات دقیق
add Commenter(emailAddress)
کاربر داده شده را به لیست نظر دهندگان File
اضافه کنید. اگر کاربر قبلاً در لیست بینندگان بوده است، این روش کاربر را از لیست بینندگان خارج می کند.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای افزودن |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
کاربر داده شده را به لیست نظر دهندگان File
اضافه کنید. اگر کاربر قبلاً در لیست بینندگان بوده است، این روش کاربر را از لیست بینندگان خارج می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
آرایه داده شده از کاربران را به لیست نظر دهندگان File
اضافه کنید. اگر هر یک از کاربران قبلاً در لیست بینندگان بودند، این روش آنها را از لیست بینندگان خارج می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Addresses | String[] | مجموعه ای از آدرس های ایمیل کاربران برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
کاربر داده شده را به لیست ویرایشگرهای File
اضافه می کند. اگر کاربر قبلاً در لیست بینندگان بوده است، این روش کاربر را از لیست بینندگان خارج می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای افزودن |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Editor(user)
کاربر داده شده را به لیست ویرایشگرهای File
اضافه می کند. اگر کاربر قبلاً در لیست بینندگان بوده است، این روش کاربر را از لیست بینندگان خارج می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
آرایه داده شده از کاربران را به لیست ویرایشگرهای File
اضافه می کند. اگر هر یک از کاربران قبلاً در لیست بینندگان بودند، این روش آنها را از لیست بینندگان خارج می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Addresses | String[] | مجموعه ای از آدرس های ایمیل کاربران برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
کاربر داده شده را به لیست بینندگان File
اضافه می کند. اگر کاربر قبلاً در لیست ویرایشگرها بوده است، این روش هیچ تاثیری ندارد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای افزودن |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
کاربر داده شده را به لیست بینندگان File
اضافه می کند. اگر کاربر قبلاً در لیست ویرایشگرها بوده است، این روش هیچ تاثیری ندارد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
آرایه داده شده از کاربران را به لیست بینندگان File
اضافه می کند. اگر هر یک از کاربران قبلاً در لیست ویرایشگرها بودند، این روش برای آنها تأثیری ندارد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Addresses | String[] | مجموعه ای از آدرس های ایمیل کاربران برای افزودن. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
get Access(email)
مجوز اعطا شده به یک کاربر خاص را دریافت می کند. این روش از بازگرداندن مجوزهای یک گروه Google یا مجوزهای به ارث رسیده از طریق Google Groups پشتیبانی نمی کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email | String | آدرس ایمیل کاربری که مجوزهایش باید بررسی شود. Google Groups پشتیبانی نمی شود. |
بازگشت
Permission
- مجوزهایی که به کاربر داده می شود.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Access(user)
مجوز اعطا شده به یک کاربر خاص را دریافت می کند. این روش از بازگرداندن مجوزهای یک گروه Google یا مجوزهای به ارث رسیده از طریق Google Groups پشتیبانی نمی کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایش کاربری که مجوزهایش باید بررسی شود. |
بازگشت
Permission
- مجوزهایی که به کاربر داده می شود.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get As(contentType)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنههای جدید Google Workspace ممکن است به طور موقت مشمول سهمیههای سختگیرانهتر شوند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
content Type | String | نوع MIME برای تبدیل. برای اکثر حبابها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است. |
بازگشت
Blob
- داده ها به عنوان یک لکه.
get Blob()
get Date Created()
get Description()
get Download Url()
آدرس اینترنتی را دریافت می کند که می توان از آن برای دانلود فایل استفاده کرد. فقط کاربرانی که اجازه باز کردن فایل در Google Drive را دارند می توانند به URL دسترسی داشته باشند. میتوانید از این URL در مرورگر برای دانلود فایل استفاده کنید، اما نمیتوانید برای واکشی فایل با Url Fetch App
استفاده کنید. اگر محتویات فایل را در اسکریپت میخواهید، از get Blob()
استفاده کنید.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
بازگشت
String
- URL که می تواند برای دانلود فایل استفاده شود.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Editors()
لیست ویرایشگرهای این File
را دریافت می کند. اگر کاربری که اسکریپت را اجرا می کند دسترسی ویرایش به File
نداشته باشد، این روش یک آرایه خالی را برمی گرداند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
بازگشت
User[]
- اگر کاربر برای این File
دسترسی ویرایش داشته باشد، لیست ویرایشگرها را برمی گرداند. اگر کاربر دسترسی ویرایش نداشته باشد، یک آرایه خالی برمی گرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Id()
get Last Updated()
get Mime Type()
نوع MIME فایل را دریافت می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
بازگشت
String
- نوع MIME فایل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Name()
get Owner()
صاحب فایل را دریافت می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
بازگشت
User
- مالک فایل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Parents()
مجموعه ای از پوشه ها را دریافت می کند که والدین مستقیم File
هستند.
بازگشت
Folder Iterator
- مجموعه ای از پوشه ها که والدین مستقیم File
هستند
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Resource Key()
کلید منبع File
را دریافت می کند که برای دسترسی به مواردی که با استفاده از پیوند به اشتراک گذاشته شده اند مورد نیاز است.
بازگشت
String
- کلید منبع File
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Eligible()
دریافت که آیا این File
واجد شرایط اعمال بهروزرسانی امنیتی است که برای دسترسی به آن نیاز به کلید منبع دارد یا خیر.
Drive برای دسترسی به برخی فایلها یا پوشههایی که با استفاده از پیوند به اشتراک گذاشته شدهاند، به یک کلید منبع نیاز دارد. این تغییر بخشی از یک بهروزرسانی امنیتی است. بهروزرسانی بهطور پیشفرض برای فایلها و پوشههای واجد شرایط روشن است. برای روشن یا خاموش کردن نیاز کلید منبع برای فایلهای واجد شرایط، set Security Update Enabled
استفاده کنید.
درباره بهروزرسانی امنیتی Google Drive بیشتر بیاموزید.
بازگشت
Boolean
- آیا میتوان مورد نیاز کلید منبع را برای File
اعمال کرد یا خیر.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Enabled()
دریافت می کند که آیا این File
برای دسترسی به یک کلید منبع نیاز دارد یا خیر. این نیاز به طور پیشفرض برای فایلها و پوشههای واجد شرایط روشن است. برای روشن یا خاموش کردن نیاز کلید منبع برای فایلهای واجد شرایط، از setSecurityUpdateEnabled
استفاده کنید.
درباره بهروزرسانی امنیتی Google Drive بیشتر بیاموزید.
بازگشت
Boolean
- اینکه آیا نیاز کلید منبع برای این File
فعال است یا خیر.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Access()
مشخص می کند که چه دسته ای از کاربران می توانند به File
دسترسی داشته باشند، علاوه بر هر کاربر فردی که به صراحت به آنها دسترسی داده شده است.
بازگشت
Access
- کدام دسته از کاربران می توانند به File
دسترسی داشته باشند
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Permission()
به کاربرانی که میتوانند به File
دسترسی داشته باشند، مجوز اعطا میکند، علاوه بر هر کاربر فردی که صریحاً به آنها دسترسی داده شده است.
بازگشت
Permission
- مجوزهایی که به کاربرانی که می توانند به File
دسترسی داشته باشند داده می شود
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Size()
تعداد بایت های مورد استفاده برای ذخیره File
در Drive را دریافت می کند. توجه داشته باشید که فایلهای برنامه Google Workspace جزو محدودیتهای فضای ذخیرهسازی Drive حساب نمیشوند و بنابراین 0
بایت برمیگردانند.
بازگشت
Integer
- تعداد بایت هایی که برای ذخیره File
در Drive استفاده می شود
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Target Id()
اگر این یک میانبر است، شناسه موردی را که به آن اشاره می کند برمی گرداند.
در غیر این صورت null
برمی گرداند.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
بازگشت
String
- شناسه مورد هدف.
get Target Mime Type()
اگر این یک میانبر است، نوع mime موردی را که به آن اشاره می کند برمی گرداند.
در غیر این صورت null
برمی گرداند.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
بازگشت
String
- نوع میم مورد هدف.
get Target Resource Key()
اگر فایل یک میانبر باشد، کلید منبع موردی را که به آن اشاره می کند برمی گرداند. کلید منبع یک پارامتر اضافی است که برای دسترسی به فایلهایی که با استفاده از پیوند به اشتراک گذاشته شدهاند، باید آن را پاس کنید.
اگر فایل میانبر نباشد، null
برمیگرداند.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
بازگشت
String
- اگر فایل میانبر نباشد، کلید منبع مورد هدف یا null
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Thumbnail()
یک تصویر بندانگشتی برای فایل دریافت میکند، یا اگر تصویر کوچکی وجود نداشته باشد، null
.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
بازگشت
Blob
- تصویر کوچک برای فایل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Url()
نشانی اینترنتی را دریافت میکند که میتوان از آن برای باز کردن File
در یک برنامه Google مانند Drive یا Docs استفاده کرد.
بازگشت
String
- نشانی اینترنتی است که می توان برای مشاهده این File
در یک برنامه Google مانند Drive یا Docs استفاده کرد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Viewers()
لیست بینندگان و نظر دهندگان این File
را دریافت می کند. اگر کاربری که اسکریپت را اجرا می کند دسترسی ویرایش به File
نداشته باشد، این روش یک آرایه خالی را برمی گرداند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
بازگشت
User[]
- اگر کاربر برای این File
دسترسی ویرایش داشته باشد، لیست بینندگان و نظر دهندگان را برمی گرداند. اگر کاربر دسترسی ویرایش نداشته باشد، یک آرایه خالی برمی گرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Starred()
تعیین می کند که آیا File
در Drive کاربر ستاره گذاری شده است یا خیر.
بازگشت
Boolean
- true
اگر File
در درایو کاربر ستارهدار باشد. false
اگر نه
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Trashed()
تعیین می کند که آیا File
در سطل زباله درایو کاربر قرار دارد یا خیر.
بازگشت
Boolean
- true
اگر File
در سطل زباله درایو کاربر باشد. false
اگر نه
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
make Copy()
یک کپی از فایل ایجاد می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
بازگشت
File
- کپی جدید.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
یک کپی از فایل در فهرست مقصد ایجاد می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
destination | Folder | دایرکتوری برای کپی کردن فایل |
بازگشت
File
- کپی جدید.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
make Copy(name)
یک کپی از فایل ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
name | String | نام فایلی که باید روی کپی جدید اعمال شود. |
بازگشت
File
- کپی جدید.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
یک کپی از فایل در فهرست مقصد ایجاد می کند و آن را با نام ارائه شده نامگذاری می کند.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
name | String | نام فایلی که باید روی کپی جدید اعمال شود. |
destination | Folder | دایرکتوری برای کپی کردن فایل |
بازگشت
File
- کپی جدید.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
move To(destination)
این مورد را به پوشه مقصد ارائه شده منتقل می کند.
کاربر فعلی باید مالک فایل باشد یا حداقل به پوشه والد فعلی مورد دسترسی ویرایش داشته باشد تا بتواند مورد را به پوشه مقصد منتقل کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
destination | Folder | پوشه ای که به والد جدید تبدیل می شود. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
کاربر داده شده را از لیست نظر دهندگان File
حذف می کند. اگر کاربران به دستهای از کاربرانی تعلق دارند که دسترسی عمومی دارند - به عنوان مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، این روش مانع از دسترسی کاربران به File
نمیشود.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای حذف. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
کاربر داده شده را از لیست نظر دهندگان File
حذف می کند. اگر کاربران به دستهای از کاربرانی تعلق دارند که دسترسی عمومی دارند - به عنوان مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، این روش مانع از دسترسی کاربران به File
نمیشود.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای حذف. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
کاربر داده شده را از لیست ویرایشگرهای File
حذف می کند. اگر کاربران به دستهای از کاربرانی که دسترسی عمومی دارند - برای مثال اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر File
در یک درایو مشترک است، این روش دسترسی به File
را مسدود نمیکند. می تواند دسترسی داشته باشد.
برای فایلهای Drive، این کار همچنین کاربر را از لیست بینندگان حذف میکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای حذف. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
کاربر داده شده را از لیست ویرایشگرهای File
حذف می کند. اگر کاربران به دستهای از کاربرانی که دسترسی عمومی دارند - برای مثال اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر File
در یک درایو مشترک است، این روش دسترسی به File
را مسدود نمیکند. می تواند دسترسی داشته باشد.
برای فایلهای Drive، این کار همچنین کاربر را از لیست بینندگان حذف میکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای حذف. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
کاربر داده شده را از لیست بینندگان و نظر دهندگان File
حذف می کند. اگر کاربر ویرایشگر باشد، نه بیننده یا نظر دهنده، این روش تاثیری ندارد. این روش همچنین اگر کاربران متعلق به دستهای از کاربرانی هستند که دسترسی عمومی دارند، دسترسی به File
را مسدود نمیکند - برای مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر File
در یک درایو مشترک است که کاربر می تواند دسترسی داشته باشد.
برای فایلهای Drive، این کار همچنین کاربر را از لیست ویرایشگرها حذف میکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربر برای حذف. |
بازگشت
File
- این File
برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
کاربر داده شده را از لیست بینندگان و نظر دهندگان File
حذف می کند. اگر کاربر ویرایشگر باشد، نه بیننده، این روش تاثیری ندارد. این روش همچنین اگر کاربران متعلق به دستهای از کاربرانی هستند که دسترسی عمومی دارند، دسترسی به File
را مسدود نمیکند - برای مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر File
در یک درایو مشترک است که کاربر می تواند دسترسی داشته باشد.
برای فایلهای Drive، این کار همچنین کاربر را از لیست ویرایشگرها حذف میکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایشی از کاربر برای حذف. |
بازگشت
File
- این File
برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
دسترسی به File
که به کاربر داده شده داده شده را لغو می کند. اگر کاربران به دستهای از کاربرانی تعلق دارند که دسترسی عمومی دارند - به عنوان مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، این روش دسترسی به File
را مسدود نمیکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربری که دسترسی او باید لغو شود. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
دسترسی به File
که به کاربر داده شده داده شده را لغو می کند. اگر کاربران به دستهای از کاربرانی تعلق دارند که دسترسی عمومی دارند - به عنوان مثال، اگر File
با کل دامنه کاربر به اشتراک گذاشته شده باشد، این روش دسترسی به File
را مسدود نمیکند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایندگی از کاربری که دسترسی او باید لغو شود. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Content(content)
محتوای فایل را با یک جایگزین معین بازنویسی می کند. در صورتی که content
بزرگتر از 10 مگابایت باشد، یک استثنا ایجاد می کند.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
content | String | محتوای جدید برای فایل. |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Description(description)
set Name(name)
set Owner(emailAddress)
مالک File
را تغییر می دهد. این روش همچنین به مالک قبلی دسترسی ویرایش صریح به File
را می دهد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
email Address | String | آدرس ایمیل کاربری که باید مالک جدید شود |
بازگشت
File
- این File
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Owner(user)
مالک File
را تغییر می دهد. این روش همچنین به مالک قبلی دسترسی ویرایش صریح به File
را می دهد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
user | User | نمایش کاربری که باید مالک جدید شود |
بازگشت
File
- این File
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
تعیین می کند که آیا File
هنگام اشتراک گذاری با استفاده از پیوند، به کلید منبع برای دسترسی نیاز دارد یا خیر. فایل ها و پوشه های واجد شرایط به طور پیش فرض فعال هستند.
درباره بهروزرسانی امنیتی Google Drive بیشتر بیاموزید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
enabled | Boolean | فعال کردن کلید منبع مورد نیاز برای File . |
بازگشت
File
- این File
، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
تعیین می کند که کدام دسته از کاربران می توانند به File
دسترسی داشته باشند و چه مجوزهایی به آن کاربران اعطا می شود، علاوه بر هر کاربر فردی که به طور صریح به آنها دسترسی داده شده است.
// Creates a folder that anyone on the Internet can read from and write to. // (Domain administrators can prohibit this setting for users of a Google // Workspace domain.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
access Type | Access | کدام دسته از کاربران باید بتوانند به File دسترسی داشته باشند |
permission Type | Permission | مجوزهایی که باید به کاربرانی که می توانند به File دسترسی داشته باشند داده شود |
بازگشت
File
- این File
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
تعیین میکند که آیا File
در Drive کاربر ستارهدار شود یا خیر. پیش فرض برای File
جدید false
است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
starred | Boolean | true اگر File باید در درایو کاربر ستاره دار شود. false اگر نه |
بازگشت
File
- این File
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
تعیین می کند که آیا File
در سطل زباله درایو کاربر قرار دارد یا خیر. فقط مالک میتواند File
را حذف کند. پیش فرض برای File
جدید false
است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
trashed | Boolean | true اگر File باید به سطل زباله درایو کاربر منتقل شود. false اگر نه |
بازگشت
File
- این File
، برای زنجیر کردن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/drive