Drive Service

رانندگی کنید

این سرویس به اسکریپت‌ها اجازه می‌دهد فایل‌ها و پوشه‌ها را در Google Drive ایجاد، پیدا و تغییر دهند.

اگر اسکریپت شما از یک پروژه استاندارد Cloud به جای پروژه پیش‌فرض Cloud استفاده می‌کند، باید به صورت دستی Drive API را روشن کنید. در پروژه استاندارد Cloud خود، Drive API را روشن کنید:

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 را روشن کنید:

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 نشانی اینترنتی عکس کاربر را دریافت می کند.