این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

REST Resource: permissions

منبع: مجوز
- نمایندگی JSON
روش ها

منبع: مجوز

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

به‌طور پیش‌فرض، درخواست‌های مجوز فقط زیرمجموعه‌ای از فیلدها را برمی‌گردانند. نوع مجوز، شناسه، نوع و نقش همیشه برگردانده می شود. برای بازیابی فیلدهای خاص، به https://developers.google.com/drive/api/guides/fields-parameter مراجعه کنید.

برخی از روش‌های منبع (مانند permissions.update ) به یک permissionId نیاز دارند. از روش permissions.list برای بازیابی شناسه فایل، پوشه یا درایو مشترک استفاده کنید.

نمایندگی JSON
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean }

نمایندگی JSON

{
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}

فیلدها
`id`	`string` فقط خروجی شناسه این مجوز. این یک شناسه منحصر به فرد برای دریافت کننده اعطا است و در منابع کاربر به عنوان `permissionId` منتشر می شود. شناسه ها باید به عنوان مقادیر غیر شفاف تلقی شوند.
`displayName`	`string` فقط خروجی نام "زیبا" مقدار مجوز. در زیر فهرستی از نمونه‌هایی برای هر نوع مجوز آمده است: `user` - نام کامل کاربر، همانطور که برای حساب Google آنها تعریف شده است، مانند "Joe Smith." `group` - نام گروه Google، مانند "مدیران شرکت." `domain` - نام دامنه رشته ای، مانند "thecompany.com." `anyone` - هیچ `displayName` وجود ندارد.
`type`	`string` نوع اعطا کننده. مقادیر معتبر عبارتند از: `user` `group` `domain` `anyone` هنگام ایجاد مجوز، اگر `type` `user` یا `group` است، باید یک `emailAddress` برای کاربر یا گروه ارائه دهید. وقتی `type` `domain` است، باید یک `domain` ارائه کنید. اطلاعات اضافی برای هر نوع `anyone` مورد نیاز نیست.
`kind`	`string` فقط خروجی مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت `"drive#permission"` .
`permissionDetails[]`	`object` فقط خروجی جزئیات مربوط به اینکه آیا مجوزهای این مورد درایو مشترک به ارث رسیده است یا مستقیماً روی این مورد. این یک فیلد فقط خروجی است که فقط برای موارد درایو مشترک وجود دارد.
`permissionDetails[].permissionType`	`string` فقط خروجی نوع مجوز برای این کاربر. در حالی که ممکن است مقادیر جدیدی در آینده اضافه شوند، موارد زیر در حال حاضر امکان پذیر است: `file` `member`
`permissionDetails[].inheritedFrom`	`string` فقط خروجی شناسه موردی که این مجوز از آن به ارث رسیده است. این یک فیلد فقط خروجی است.
`permissionDetails[].role`	`string` فقط خروجی نقش اصلی برای این کاربر. در حالی که ممکن است مقادیر جدیدی در آینده اضافه شوند، موارد زیر در حال حاضر امکان پذیر است: `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` استفاده کنید.
`teamDrivePermissionDetails[] (deprecated) .teamDrivePermissionType (deprecated)`	`string` منسوخ شده: فقط خروجی. به جای آن از `permissionDetails/permissionType` استفاده کنید.
`teamDrivePermissionDetails[] (deprecated) .inheritedFrom (deprecated)`	`string` منسوخ شده: فقط خروجی. به جای آن از `permissionDetails/inheritedFrom` استفاده کنید.
`teamDrivePermissionDetails[] (deprecated) .role (deprecated)`	`string` منسوخ شده: فقط خروجی. به جای آن از `permissionDetails/role` استفاده کنید.
`teamDrivePermissionDetails[] (deprecated) .inherited (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `permissionDetails/inherited` استفاده کنید.
`deleted`	`boolean` فقط خروجی آیا حساب مرتبط با این مجوز حذف شده است یا خیر. این قسمت فقط به مجوزهای کاربر و گروه مربوط می شود.
`view`	`string` نمای این مجوز را نشان می دهد. فقط برای مجوزهایی که به یک View تعلق دارند پر شده است. "منتشر شده" تنها مقدار پشتیبانی شده است.
`pendingOwner`	`boolean` آیا حساب مرتبط با این مجوز مالک معلق است یا خیر. فقط برای مجوزهای نوع `user` برای فایل‌هایی که در درایو مشترک نیستند پر شده است.

روش ها
`create`	یک مجوز برای یک فایل یا درایو مشترک ایجاد می کند.
`delete`	یک مجوز را حذف می کند.
`get`	با شناسه مجوز می گیرد.
`list`	مجوزهای یک فایل یا درایو مشترک را فهرست می کند.
`update`	یک مجوز را با معنای پچ به روز می کند.

REST Resource: permissions

منبع: مجوز

روش ها

`create`

`delete`

`get`

`list`

`update`