برخی از روش‌های منبع (مانند permissions.update ) به یک permissionId نیاز دارند. از روش permissions.list برای بازیابی شناسه فایل، پوشه یا درایو مشترک استفاده کنید.
فقط خروجی شناسه این مجوز. این یک شناسه منحصر به فرد برای دریافت کننده اعطا است و در منابع کاربر به عنوان permissionId منتشر می شود. شناسه ها باید به عنوان مقادیر غیر شفاف تلقی شوند.
displayName
string
فقط خروجی نام "زیبا" مقدار مجوز. در زیر فهرستی از نمونه‌هایی برای هر نوع مجوز آمده است:
user - نام کامل کاربر، همانطور که برای حساب Google آنها تعریف شده است، مانند "Joe Smith."
group - نام گروه Google، مانند "مدیران شرکت."
domain - نام دامنه رشته ای، مانند "thecompany.com."
anyone - هیچ displayName وجود ندارد.
type
string
نوع اعطا کننده. مقادیر معتبر عبارتند از:
user
group
domain
anyone
هنگام ایجاد مجوز، اگر typeuser یا group است، باید یک emailAddress برای کاربر یا گروه ارائه دهید. وقتی typedomain است، باید یک domain ارائه کنید. اطلاعات اضافی برای هر نوع anyone مورد نیاز نیست.
kind
string
فقط خروجی مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "drive#permission" .
permissionDetails[]
object
فقط خروجی جزئیات مربوط به اینکه آیا مجوزهای این مورد ارثی هستند یا مستقیماً روی این مورد.
permissionDetails[].permissionType
string
فقط خروجی نوع مجوز برای این کاربر. در حالی که ممکن است مقادیر جدیدی در آینده اضافه شوند، موارد زیر در حال حاضر امکان پذیر است:
file
member
permissionDetails[].inheritedFrom
string
فقط خروجی شناسه موردی که این مجوز از آن به ارث رسیده است. این فقط برای موارد موجود در درایوهای مشترک پر شده است.
permissionDetails[].role
string
فقط خروجی نقش اصلی برای این کاربر. در حالی که ممکن است مقادیر جدیدی در آینده اضافه شوند، موارد زیر در حال حاضر امکان پذیر است:
owner
organizer
fileOrganizer
writer
commenter
reader
permissionDetails[].inherited
boolean
فقط خروجی اینکه آیا این اجازه موروثی است. این فیلد همیشه پر است. این یک فیلد فقط خروجی است.
photoLink
string
فقط خروجی پیوندی به عکس نمایه کاربر، در صورت وجود.
emailAddress
string
آدرس ایمیل کاربر یا گروهی که این مجوز به آن اشاره دارد.
role
string
نقش اعطا شده توسط این مجوز. در حالی که مقادیر جدید ممکن است در آینده پشتیبانی شوند، موارد زیر در حال حاضر مجاز هستند:
owner
organizer
fileOrganizer
writer
commenter
reader
allowFileDiscovery
boolean
آیا مجوز اجازه می دهد تا فایل از طریق جستجو کشف شود. این فقط برای مجوزهای نوع domain یا anyone قابل اجرا است.
domain
string
دامنه ای که این مجوز به آن اشاره دارد.
expirationTime
string
زمانی که این مجوز منقضی می شود (RFC 3339 date-time). زمان انقضا دارای محدودیت های زیر است:
آنها را فقط می توان روی مجوزهای کاربر و گروه تنظیم کرد.
زمان باید در آینده باشد.
زمان در آینده نمی تواند بیش از یک سال باشد.
teamDrivePermissionDetails[] (deprecated)
object
فقط خروجی منسوخ شده: فقط خروجی. به جای آن از permissionDetails استفاده کنید.
تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی."],[[["The Permission resource manages access control to files and folders within Google Drive, granting permissions to users, groups, domains, or the world."],["Permission details include the grantee type (user, group, domain, anyone), role (owner, organizer, writer, etc.), and optional expiration time."],["Use the `permissions.list` method to retrieve a permission ID, which is needed for methods like `permissions.update`."],["Dedicated methods exist for creating, deleting, retrieving, listing, and updating permissions."],["Permissions on shared drive items can be directly applied or inherited, and this information is available in the `permissionDetails` field."]]],["Permissions grant access to files or folders for users, groups, domains, or the public. Key permission attributes include `id`, `type` (user, group, domain, anyone), `role` (owner, reader, etc.), and `emailAddress`. Permissions can be inherited or direct, with details stored in `permissionDetails`. Permissions have methods to `create`, `delete`, `get`, `list`, and `update`. When creating permissions of type user or group an `emailAddress` must be provided, for type `domain` the domain must be provided. `permissions.update` requires a `permissionId` which can be retrieved with `permissions.list`.\n"]]
