Method: permissions.create

• درخواست HTTP
• پارامترهای مسیر
• پارامترهای پرس و جو
• درخواست بدن
• بدن پاسخگو
• محدوده مجوز
• آن را امتحان کنید!

یک مجوز برای یک فایل یا درایو مشترک ایجاد می کند. برای اطلاعات بیشتر، به اشتراک گذاری فایل ها، پوشه ها و درایوها مراجعه کنید.

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

درخواست HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

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

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

پارامترها
fileId	string شناسه فایل یا درایو مشترک.

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

پارامترها
emailMessage	string یک پیام متنی ساده برای درج در ایمیل اعلان.
enforceSingleParent (deprecated)	boolean منسوخ شده: برای جزئیات بیشتر به moveToNewOwnersRoot مراجعه کنید.
moveToNewOwnersRoot	boolean این پارامتر فقط در صورتی اعمال می‌شود که مورد در درایو مشترک نباشد و درخواست در حال تلاش برای انتقال مالکیت آن مورد باشد. اگر روی true تنظیم شود، مورد به پوشه ریشه My Drive مالک جدید منتقل می‌شود و تمام والدین قبلی حذف می‌شوند. اگر روی false تنظیم شود، والدین تغییر نمی کنند.
sendNotificationEmail	boolean آیا هنگام اشتراک‌گذاری با کاربران یا گروه‌ها، ایمیل اعلان ارسال شود. این پیش‌فرض برای کاربران و گروه‌ها true است و برای سایر درخواست‌ها مجاز نیست. برای انتقال مالکیت نباید غیرفعال شود.
supportsAllDrives	boolean اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند.
supportsTeamDrives (deprecated)	boolean منسوخ شده: به جای آن از supportsAllDrives استفاده کنید.
transferOwnership	boolean اینکه آیا برای انتقال مالکیت به کاربر مشخص شده و تنزل رتبه مالک فعلی به یک نویسنده. این پارامتر به عنوان تأیید عارضه جانبی مورد نیاز است. برای اطلاعات بیشتر، به انتقال مالکیت فایل مراجعه کنید.
useDomainAdminAccess	boolean درخواست را به عنوان مدیر دامنه صادر کنید. اگر روی true تنظیم شود، و اگر شرایط اضافی زیر وجود داشته باشد، به درخواست کننده اجازه دسترسی داده می شود: پارامتر شناسه فایل به یک درایو مشترک اشاره دارد. درخواست کننده مدیر دامنه ای است که درایو مشترک به آن تعلق دارد. برای اطلاعات بیشتر، به مدیریت درایوهای مشترک به عنوان سرپرست دامنه مراجعه کنید.
enforceExpansiveAccess	boolean اینکه آیا درخواست باید قوانین دسترسی گسترده را اعمال کند یا خیر.

درخواست بدن

بدنه درخواست حاوی نمونه‌ای از Permission است.

بدن پاسخگو

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

محدوده مجوز

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

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

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