REST Resource: matters.holds

المرجع: تعليق

مبلغ محجوز مؤقتًا في الحساب تمنع عملية تجميد البيانات خدمة Google Workspace المحدّدة من محو البيانات لحسابات معيّنة أو جميع أعضاء وحدة تنظيمية.

للعمل مع موارد Vault، يجب أن يمتلك الحساب امتيازات Vault المطلوبة وأن يكون لديه إذن الوصول إلى المسألة القانونية. للوصول إلى مسألة قانونية، يجب أن يكون الحساب قد أنشأها أو تمت مشاركتها معه أو أن يكون لديه امتياز عرض جميع المسائل القانونية.

تمثيل JSON 
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
الحقول
holdId

string

المعرّف الفريد غير القابل للتغيير للمبلغ المحجوز مؤقتًا. يتمّ تعيينها أثناء الإنشاء.
name

string

اسم عملية تجميد البيانات
updateTime

string (Timestamp format)

آخر مرة تم فيها تعديل هذا المبلغ المحجوز مؤقتًا

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
accounts[]

object (HeldAccount)

في حال ضبطه، ينطبق تجميد البيانات على الحسابات المحدّدة ويجب أن يكون orgUnit فارغًا.
orgUnit

object (HeldOrgUnit)

في حال ضبط الإعداد، تنطبق عملية تجميد البيانات على جميع أعضاء الوحدة التنظيمية ويجب أن تكون الحسابات فارغة. هذه السمة قابلة للتغيير. بالنسبة إلى عمليات تجميد بيانات المجموعات، اضبط الحسابات.
corpus

enum (CorpusType)

الخدمة التي سيتم البحث عنها.
query

object (CorpusQuery)

الخيارات الخاصة بالخدمة في حال ضبطها، يجب أن تتطابق CorpusQuery مع CorpusType.

HeldOrgUnit

الوحدة التنظيمية التي تم تجميد بياناتها هذه البنية غير قابلة للتغيير.

تمثيل JSON 
{
  "orgUnitId": string,
  "holdTime": string
}
الحقول
orgUnitId

string

رقم تعريف الوحدة التنظيمية غير القابل للتغيير كما تقدّمه حزمة تطوير البرامج (SDK) للمشرف.
holdTime

string (Timestamp format)

وقت تجميد الوحدة التنظيمية هذه السمة غير قابلة للتغيير.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

CorpusQuery

خيارات خاصة بالخدمة للحجز

تمثيل JSON 
{

  // Union field corpus_query can be only one of the following:
  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  }
  // End of list of possible types for union field corpus_query.
}
الحقول
حقل الربط corpus_query في حال ضبط هذا الإعداد، يجب أن يتطابق مع نوع الخدمة. يمكن أن يكون corpus_query واحدًا فقط مما يلي:
driveQuery

object (HeldDriveQuery)

خيارات خاصة بالخدمة لعمليات تجميد البيانات في Drive إذا تم ضبط السمة CorpusType، يجب أن تكون قيمتها DRIVE.
mailQuery

object (HeldMailQuery)

خيارات خاصة بالخدمة لعمليات الاحتفاظ بالبيانات في Gmail إذا تم ضبط السمة CorpusType، يجب أن تكون قيمتها MAIL.
groupsQuery

object (HeldGroupsQuery)

خيارات خاصة بالخدمة لعمليات حجز المساحة في "مجموعات Google" إذا تم ضبطه، يجب أن يكون CorpusType هو GROUPS.
hangoutsChatQuery

object (HeldHangoutsChatQuery)

خيارات خاصة بالخدمة لعمليات الاحتفاظ بالبيانات في Chat إذا تم ضبطه، يجب أن يكون CorpusType هو HANGOUTS_CHAT.
voiceQuery

object (HeldVoiceQuery)

خيارات خاصة بالخدمة لميزة "وضع الانتظار" في Voice إذا تم ضبط السمة CorpusType، يجب أن تكون قيمتها VOICE.
calendarQuery

object (HeldCalendarQuery)

خيارات خاصة بالخدمة لعمليات حجز "تقويم Google" إذا تم ضبط CorpusType، يجب أن يكون CALENDAR.

HeldDriveQuery

خيارات عمليات تجميد البيانات في Drive

تمثيل JSON 
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
الحقول
includeTeamDriveFiles
(deprecated)

boolean

لتضمين الملفات في مساحات التخزين السحابي المشتركة في Team Drive في فترة التعليق، اضبط القيمة على true.
includeSharedDriveFiles

boolean

لتضمين الملفات في مساحات التخزين السحابي المشتركة في فترة التعليق، اضبط القيمة على true.

HeldMailQuery

خيارات طلب البحث لعمليات الاحتفاظ بالبيانات في Gmail

تمثيل JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
الحقول
terms

string

عوامل تشغيل البحث المستخدَمة لتحسين الرسائل المشمولة بعملية تجميد البيانات
startTime

string (Timestamp format)

وقت بدء طلب البحث حدِّد التوقيت بتوقيت غرينيتش. يتم تقريب القيمة إلى الساعة 12 منتصف الليل في التاريخ المحدّد.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

وقت انتهاء الاستعلام. حدِّد التوقيت بتوقيت غرينيتش. يتم تقريب القيمة إلى الساعة 12 منتصف الليل في التاريخ المحدّد.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

HeldGroupsQuery

خيارات طلب البحث عن عمليات تجميد البيانات في المجموعات

تمثيل JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
الحقول
terms

string

عوامل تشغيل البحث المستخدَمة لتحسين الرسائل المشمولة بعملية تجميد البيانات
startTime

string (Timestamp format)

وقت بدء طلب البحث حدِّد التوقيت بتوقيت غرينيتش. يتم تقريب القيمة إلى الساعة 12 صباحًا في التاريخ المحدّد.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

وقت انتهاء الاستعلام. حدِّد التوقيت بتوقيت غرينيتش. يتم تقريب القيمة إلى الساعة 12 منتصف الليل في التاريخ المحدّد.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

HeldHangoutsChatQuery

خيارات عمليات تجميد البيانات في Chat

تمثيل JSON 
{
  "includeRooms": boolean
}
الحقول
includeRooms

boolean

لتضمين الرسائل في مساحات Chat التي كان المستخدم عضوًا فيها، اضبط القيمة على true.

HeldVoiceQuery

خيارات الانتظار في Voice

تمثيل JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
الحقول
coveredData[]

enum (VoiceCoveredData)

قائمة بأنواع البيانات التي تشملها فترة التعليق يجب ألا يكون فارغًا. ولا يهمّ الترتيب ويتم تجاهل النُسخ المكرّرة.

HeldCalendarQuery

لا يحتوي هذا النوع على أي حقول.

خيارات عمليات تجميد البيانات في "تقويم Google"

الطُرق

addHeldAccounts

 تُضيف حسابات إلى عملية الاحتفاظ بالبيانات.

create

 يتم إنشاء حالة تجميد بيانات في المسألة القانونية المحدّدة.

delete

 تزيل هذه العملية عملية تجميد البيانات المحدّدة وتُطلق الحسابات أو الوحدة التنظيمية التي تشملها عملية تجميد البيانات.

get

 الحصول على حالة تجميد البيانات المحدّدة

list

 يسرد عمليات تجميد البيانات في مسألة قانونية.

removeHeldAccounts

 تزيل الحسابات المحدّدة من حالة التعليق.

update

 تعديل النطاق (الوحدة التنظيمية أو الحسابات) ومَعلمات طلب البحث لعملية تجميد البيانات