Google Vault API

الاحتفاظ بالبيانات وجمع الأدلة الإلكترونية في Google Workspace

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

• مورد REST: ‏ v1.matters
• مورد REST: ‏ v1.matters.exports
• مورد REST: ‏ v1.matters.holds
• مورد REST: ‏ v1.matters.holds.accounts
• مورد REST: ‏ v1.matters.savedQueries
• مورد REST: ‏ v1.operations

الخدمة: vault.googleapis.com

للاتصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.

المستند المرتبط بميزة "اقتراحات"

مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

• https://vault.googleapis.com/$discovery/rest?version=v1

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

• https://vault.googleapis.com

مورد REST: ‏ v1.matters

الطُرق
addPermissions	POST /v1/matters/{matterId}:addPermissions تُستخدَم هذه القيمة لإضافة حساب كمتعاون في الطلب.
close	POST /v1/matters/{matterId}:close يؤدي هذا الإجراء إلى إغلاق المسألة القانونية المحدّدة.
count	POST /v1/matters/{matterId}:count تُحتسَب الحسابات التي تمت معالجتها من خلال طلب البحث المحدّد.
create	POST /v1/matters يتم إنشاء مسألة قانونية بالاسم والوصف المُقدِّمان.
delete	DELETE /v1/matters/{matterId} يؤدي هذا الإجراء إلى حذف المسألة القانونية المحدّدة.
get	GET /v1/matters/{matterId} تحصل على الطلب المحدّد.
list	GET /v1/matters يتم سرد كل المسائل القانونية التي حصل مقدم الطلب على حق الوصول إليها.
removePermissions	POST /v1/matters/{matterId}:removePermissions تؤدي هذه العملية إلى إزالة حساب كمتعاون في الطلب.
reopen	POST /v1/matters/{matterId}:reopen تؤدي هذه العملية إلى إعادة فتح المسألة القانونية المحدّدة.
undelete	POST /v1/matters/{matterId}:undelete يؤدي هذا الإجراء إلى إلغاء حذف المسألة القانونية المحدّدة.
update	PUT /v1/matters/{matterId} لتعديل المسألة المحدّدة.

مورد REST: ‏ v1.matters.exports

الطُرق
create	POST /v1/matters/{matterId}/exports لإنشاء عملية تصدير.
delete	DELETE /v1/matters/{matterId}/exports/{exportId} لحذف عملية تصدير.
get	GET /v1/matters/{matterId}/exports/{exportId} تحصل على عملية تصدير.
list	GET /v1/matters/{matterId}/exports تعرض هذه السمة تفاصيل عن عمليات التصدير في الموضوع المحدّد.

مورد REST: ‏ v1.matters.holds

الطُرق
addHeldAccounts	POST /v1/matters/{matterId}/holds/{holdId}:addHeldAccounts تُستخدَم لإضافة حسابات إلى عملية تجميد البيانات.
create	POST /v1/matters/{matterId}/holds يتم إنشاء حالة تجميد بيانات في المسألة القانونية المحدّدة.
delete	DELETE /v1/matters/{matterId}/holds/{holdId} تزيل هذه القيمة عملية تجميد البيانات المحدّدة وتُطلق الحسابات أو الوحدة التنظيمية التي تشملها عملية تجميد البيانات.
get	GET /v1/matters/{matterId}/holds/{holdId} للحصول على عملية تجميد البيانات المحدّدة.
list	GET /v1/matters/{matterId}/holds يسرد عمليات تجميد البيانات في مسألة قانونية.
removeHeldAccounts	POST /v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts تزيل الحسابات المحدّدة من حالة التعليق.
update	PUT /v1/matters/{matterId}/holds/{holdId} لتعديل النطاق (الوحدة التنظيمية أو الحسابات) ومَعلمات طلب البحث لعملية تجميد البيانات.

مورد REST: ‏ v1.matters.holds.accounts

الطُرق
create	POST /v1/matters/{matterId}/holds/{holdId}/accounts تُستخدَم لإضافة حساب إلى عملية الاحتفاظ بالبيانات.
delete	DELETE /v1/matters/{matterId}/holds/{holdId}/accounts/{accountId} تزيل حسابًا من حالة التعليق.
list	GET /v1/matters/{matterId}/holds/{holdId}/accounts يسرد الحسابات المشمولة بعملية تجميد بيانات.

مورد REST: ‏ v1.matters.savedQueries

الطُرق
create	POST /v1/matters/{matterId}/savedQueries لإنشاء طلب بحث محفوظ.
delete	DELETE /v1/matters/{matterId}/savedQueries/{savedQueryId} يؤدي هذا الإجراء إلى حذف الطلب المحفوظ المحدّد.
get	GET /v1/matters/{matterId}/savedQueries/{savedQueryId} يسترجع الطلب المحفوظ المحدّد.
list	GET /v1/matters/{matterId}/savedQueries يتم عرض طلبات البحث المحفوظة في مسألة قانونية.

مورد REST: ‏ v1.operations

الطُرق
cancel	POST /v1/{name=operations/**}:cancel يبدأ إلغاء غير متزامن لعملية تستغرق وقتًا طويلاً.
delete	DELETE /v1/{name=operations/**} لحذف عملية تستغرق وقتًا طويلاً.
get	GET /v1/{name=operations/**} تحصل على أحدث حالة لعملية طويلة الأمد.
list	GET /v1/{name} تعرض العمليات التي تتطابق مع الفلتر المحدّد في الطلب.