REST Resource: permissions

المورد: الإذن

إذن لملف يمنح الإذن مستخدمًا أو مجموعة أو نطاقًا أو الجميع إذن الوصول إلى ملف أو تسلسل هرمي للمجلدات. لمزيد من المعلومات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين.

تلقائيًا، لا تعرض طلبات الأذونات سوى مجموعة فرعية من الحقول. يتم دائمًا عرض الأذونات kind وID وtype وrole. لاسترداد حقول معيّنة، راجِع عرض حقول معيّنة.

تتطلّب بعض طرق الموارد (مثل permissions.update) استخدام permissionId. استخدِم طريقة permissions.list لاسترداد رقم تعريف ملف أو مجلد أو مساحة تخزين سحابي مشتركة.

تمثيل JSON 
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
الحقول
permissionDetails[]

object

النتائج فقط. تفاصيل حول ما إذا كانت الأذونات الممنوحة لهذا العنصر مكتسَبة أو ممنوحة مباشرةً لهذا العنصر
permissionDetails[].permissionType

string

النتائج فقط. نوع إذن هذا المستخدم تشمل القيم المسموح بها ما يلي:

  • file
  • member
permissionDetails[].inheritedFrom

string

النتائج فقط. معرّف العنصر الذي يتم اكتساب هذا الإذن منه. لا تتم تعبئة هذا الحقل إلا للعناصر في مساحات التخزين السحابي المشتركة.
permissionDetails[].role

string

النتائج فقط. دور المستخدم الأساسي تشمل القيم المسموح بها ما يلي:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

لمزيد من المعلومات، يُرجى الاطّلاع على الأدوار والأذونات.
permissionDetails[].inherited

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان هذا الإذن مكتسَبًا أم لا. يتم ملء هذا الحقل دائمًا. هذا حقل للنتائج فقط.
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 كبديل.
id

string

النتائج فقط. معرّف هذا الإذن. هذا المعرّف هو معرّف فريد للمستفيد من المنحة، ويتم نشره في مورد المستخدم كـ permissionId. يجب التعامل مع أرقام التعريف كقيم مبهمة.
displayName

string

النتائج فقط. الاسم "pretty" (جميلة) الخاص بقيمة الإذن. في ما يلي قائمة أمثلة لكل نوع من الأذونات:

  • user - الاسم الكامل للمستخدم، كما هو محدّد في حسابه على Google، مثل "Dana A."
  • استبدِل group باسم مجموعة Google، مثل "مشرفو الشركة".
  • ‫domain: اسم نطاق السلسلة، مثل "cymbalgroup.com"
  • ‫anyone - لا يتوفّر displayName.
type

string

تمثّل هذه السمة نوع المستفيد من المنحة. تشمل القيم المسموح بها ما يلي:

  • user
  • group
  • domain
  • anyone

عند إنشاء إذن، إذا كانت قيمة type هي user أو group، يجب تقديم emailAddress للمستخدم أو المجموعة. إذا كانت قيمة type هي domain، يجب تقديم domain. إذا كانت قيمة type هي anyone، لن تحتاج إلى تقديم معلومات إضافية.
kind

string

النتائج فقط. تحدّد نوع المرجع. القيمة: السلسلة الثابتة "drive#permission".
emailAddress

string

عنوان البريد الإلكتروني الخاص بالمستخدم أو المجموعة التي يشير إليها هذا الإذن
role

string

الدور الذي يمنحه هذا الإذن تشمل القيم المسموح بها ما يلي:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

لمزيد من المعلومات، يُرجى الاطّلاع على الأدوار والأذونات.
allowFileDiscovery

boolean

توضّح ما إذا كان الإذن يسمح بأن يتم العثور على الملف من خلال البحث أم لا. ينطبق ذلك فقط على الأذونات من النوع domain أو anyone.
domain

string

النطاق الذي يشير إليه هذا الإذن
expirationTime

string

الوقت الذي ستنتهي فيه صلاحية هذا الإذن (تاريخ ووقت RFC 3339) تنطبق القيود التالية على أوقات انتهاء الصلاحية:

  • لا يمكن ضبطها إلا على أذونات المستخدمين والمجموعات.
  • يجب أن يكون الوقت في المستقبل.
  • لا يمكن أن يكون الوقت بعد أكثر من عام واحد في المستقبل.
deleted

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان قد تم حذف الحساب المرتبط بهذا الإذن. لا ينطبق هذا الحقل إلا على الأذونات من النوع user أو group.
view

string

تشير إلى طريقة عرض هذا الإذن. تتم تعبئة هذا الحقل للأذونات التي تنتمي إلى طريقة عرض فقط.

القيمتان الوحيدتان المسموح بهما هما published وmetadata:

  • published: دور الإذن هو publishedReader.
  • ‫metadata: لا يظهر العنصر إلا في طريقة العرض metadata لأنّ لديه إذن وصول محدود، ولأنّ النطاق لديه إذن قراءة على الأقل للملف الأصلي. لا تتوفّر طريقة العرض metadata إلا في المجلدات.

لمزيد من المعلومات، يُرجى الاطّلاع على المشاهدات.
pendingOwner

boolean

ما إذا كان الحساب المرتبط بهذا الإذن هو مالك في انتظار المراجعة. لا تتم تعبئة هذا الحقل إلا لأذونات من النوع user للملفات غير الموجودة في مساحة تخزين سحابي مشتركة.
inheritedPermissionsDisabled

boolean

عندما تكون القيمة true، يمكن للمنظّمين والمالكين والمستخدمين الذين لديهم أذونات تمت إضافتها مباشرةً إلى العنصر الوصول إليه.

الطُرق

create

 تنشئ هذه الطريقة إذنًا لملف أو مساحة تخزين سحابي مشتركة.

delete

 يحذف هذا الإجراء إذنًا.

get

 تعرض هذه الطريقة إذنًا حسب رقم التعريف.

list

 تعرض هذه الطريقة أذونات ملف أو مساحة تخزين سحابي مشتركة.

update

 تعديل إذن باستخدام دلالات التصحيح