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 
{

  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  },
  "geminiQuery": {
    object (HeldGeminiQuery)
  }
}
الحقول
حقل الربط corpus_query في حال ضبط هذا الحقل، يجب أن يتطابق مع نوع الخدمة. يمكن أن يكون التعليق corpus_query إحدى القيم التالية فقط:
driveQuery

object (HeldDriveQuery)

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

object (HeldMailQuery)

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

object (HeldGroupsQuery)

خيارات خاصة بالخدمة لعمليات تعليق المجموعات إذا تم ضبطها، يجب أن تكون قيمة CorpusType هي GROUPS.
hangoutsChatQuery

object (HeldHangoutsChatQuery)

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

object (HeldVoiceQuery)

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

object (HeldCalendarQuery)

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

object (HeldGeminiQuery)

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

HeldDriveQuery

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

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

boolean

لإدراج الملفات في مساحات التخزين السحابي المشتركة ضمن التعليق، اضبط هذا الخيار على 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"

HeldGeminiQuery

لا يتضمّن هذا النوع أي حقول.

خيارات بشأن تعليق Gemini

الطُرق

addHeldAccounts

 تضيف هذه الطريقة حسابات إلى أمر احتفاظ.

create

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

delete

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

get

 تعرض هذه الطريقة حالة التجميد المحدّدة.

list

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

removeHeldAccounts

 تزيل هذه الطريقة الحسابات المحدّدة من أمر الاحتفاظ بالبيانات.

update

 تعدِّل هذه الطريقة النطاق (الوحدة التنظيمية أو الحسابات) ومَعلمات طلب البحث لعملية تجميد البيانات.