Query

تعريف طلب البحث المستخدَم للبحث والتصدير.

تمثيل JSON 
{
  "corpus": enum (CorpusType),
  "dataScope": enum (DataScope),
  "searchMethod": enum (SearchMethod),
  "method": enum (SearchMethod),
  "terms": string,
  "startTime": string,
  "endTime": string,
  "teamDriveInfo": {
    object (TeamDriveInfo)
  },
  "timeZone": string,

  // Union field search_method_field can be only one of the following:
  "accountInfo": {
    object (AccountInfo)
  },
  "orgUnitInfo": {
    object (OrgUnitInfo)
  },
  "sharedDriveInfo": {
    object (SharedDriveInfo)
  },
  "hangoutsChatInfo": {
    object (HangoutsChatInfo)
  },
  "sitesUrlInfo": {
    object (SitesUrlInfo)
  }
  // End of list of possible types for union field search_method_field.

  // Union field corpus_options_field can be only one of the following:
  "mailOptions": {
    object (MailOptions)
  },
  "driveOptions": {
    object (DriveOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatOptions)
  },
  "voiceOptions": {
    object (VoiceOptions)
  },
  "calendarOptions": {
    object (CalendarOptions)
  }
  // End of list of possible types for union field corpus_options_field.
}
الحقول
corpus

enum (CorpusType)

خدمة Google Workspace للبحث
dataScope

enum (DataScope)

مصدر البيانات للبحث.
searchMethod
(deprecated)

enum (SearchMethod)

طريقة البحث المستخدمة.
method

enum (SearchMethod)

الكيان المطلوب البحث فيه. يحل هذا الحقل محل searchMethod لإتاحة مساحات التخزين السحابي المشتركة. عندما تكون searchMethod هي team_DRIVE، يكون الردّ على هذا الحقل هو SHARED_DRIVE.
terms

string

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
teamDriveInfo
(deprecated)

object (TeamDriveInfo)

تكون هذه السمة مطلوبة عندما تكون قيمة SearchMethod هي team_DRIVE.
timeZone

string

اسم المنطقة الزمنية. يجب أن يكون اسم IANA TZ، مثل "America/Los_Angeles". للحصول على قائمة بأسماء المناطق الزمنية، راجِع المنطقة الزمنية. لمزيد من المعلومات حول كيفية استخدام Vault للمناطق الزمنية، يُرجى الاطّلاع على مركز مساعدة Vault.
حقل الاتحاد search_method_field. عند الحاجة، يمكن أن تكون تفاصيل الكيانات المطلوب البحث فيها عن search_method_field أحد العناصر التالية فقط:
accountInfo

object (AccountInfo)

تكون هذه السمة مطلوبة عندما تكون SearchMethod هي ACCOUNT.
orgUnitInfo

object (OrgUnitInfo)

تكون هذه السمة مطلوبة عندما تكون قيمة SearchMethod هي ORG_UNIT.
sharedDriveInfo

object (SharedDriveInfo)

تكون هذه السمة مطلوبة عندما تكون قيمة SearchMethod هي SHARED_DRIVE.
hangoutsChatInfo

object (HangoutsChatInfo)

تكون هذه السمة مطلوبة عندما تكون SearchMethod هي غرفة. (قراءة فقط)
sitesUrlInfo

object (SitesUrlInfo)

تكون هذه السمة مطلوبة عندما تكون SearchMethod هي SITES_URL.
حقل الاتحاد corpus_options_field. خيارات بحث إضافية لخدمات معينة. يمكن أن يكون corpus_options_field واحدًا فقط مما يلي:
mailOptions

object (MailOptions)

ضبط الخيارات الخاصة بالبحث في Gmail.
driveOptions

object (DriveOptions)

ضبط الخيارات الخاصة بالبحث في Drive.
hangoutsChatOptions

object (HangoutsChatOptions)

ضبط الخيارات الخاصة بالبحث في Chat (قراءة فقط)
voiceOptions

object (VoiceOptions)

يمكنك ضبط الخيارات الخاصة بالبحث الصوتي.
calendarOptions

object (CalendarOptions)

ضبط الخيارات الخاصة بالبحث في "تقويم Google"

DataScope

مصدر البيانات للبحث.

عمليات التعداد
DATA_SCOPE_UNSPECIFIED لم يتم تحديد مصدر بيانات.
ALL_DATA جميع البيانات المتاحة.
HELD_DATA البيانات قيد تجميد البيانات فقط.
UNPROCESSED_DATA البيانات فقط التي لم تتم معالجتها بعد بواسطة Vault. (Gmail و"مجموعات Google" فقط)

SearchMethod

نوع الكيان للبحث.

عمليات التعداد
SEARCH_METHOD_UNSPECIFIED يجب تحديد طريقة البحث وإلا فسيتم رفضها.
ACCOUNT ابحث عن بيانات الحسابات المحدّدة في AccountInfo.
ORG_UNIT يمكنك البحث في بيانات جميع الحسابات في الوحدة التنظيمية المحدّدة في OrgUnitInfo.
TEAM_DRIVE

البحث في البيانات في مساحة التخزين السحابي المشتركة المحدّدة في teamDriveInfo
ENTIRE_ORG البحث في بيانات جميع الحسابات في المؤسسة. لا تتوفّر هذه الميزة إلا في Gmail. وعند تحديده، لن تحتاج إلى تحديد AccountInfo أو OrgUnitInfo.
ROOM يمكنك البحث عن الرسائل في مساحات Chat المحدّدة في HangoutsChatInfo.
SITES_URL يمكنك البحث عن المواقع الإلكترونية حسب عناوين URL الخاصة بالمواقع الإلكترونية المنشورة والمحددة في SitesUrlInfo.
SHARED_DRIVE يمكنك البحث في الملفات في مساحات التخزين السحابي المشتركة المحدَّدة في SharedDriveInfo.

AccountInfo

الحسابات المراد البحث فيها

تمثيل JSON 
{
  "emails": [
    string
  ]
}
الحقول
emails[]

string

مجموعة من الحسابات للبحث فيها.

OrgUnitInfo

الوحدة التنظيمية للبحث

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

string

اسم الوحدة التنظيمية المطلوب البحث فيها، كما تم توفيره من خلال Admin SDK Directory API.

SharedDriveInfo

مساحات التخزين السحابي المشتركة للبحث

تمثيل JSON 
{
  "sharedDriveIds": [
    string
  ]
}
الحقول
sharedDriveIds[]

string

قائمة بأرقام تعريف مساحات التخزين السحابي المشتركة، على النحو الذي توفِّره Drive API.

HangoutsChatInfo

مساحات Chat المطلوب البحث فيها

تمثيل JSON 
{
  "roomId": [
    string
  ]
}
الحقول
roomId[]

string

قائمة بأرقام تعريف مساحات Chat، على النحو الذي توفِّره Chat API هناك حدّ أقصى للتصدير من 500 مساحة Chat لكل طلب.

SitesUrlInfo

عناوين URL الخاصة بالمواقع الإلكترونية المنشورة في الإصدار الجديد من "مواقع Google" المطلوب البحث فيها

تمثيل JSON 
{
  "urls": [
    string
  ]
}
الحقول
urls[]

string

قائمة بعناوين URL المنشورة للمواقع الإلكترونية.

TeamDriveInfo

مساحات التخزين السحابي المشتركة للبحث

تمثيل JSON 
{
  "teamDriveIds": [
    string
  ]
}
الحقول
teamDriveIds[]
(deprecated)

string

قائمة بأرقام تعريف مساحات Drive المشتركة، على النحو الذي توفِّره Drive API.

MailOptions

خيارات إضافية للبحث في Gmail

تمثيل JSON 
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
الحقول
excludeDrafts

boolean

اضبط القيمة على true لاستبعاد المسودات.
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

تحدِّد هذه السياسة ما إذا كان يجب أن تتضمّن النتائج محتوى مشفّرًا أو محتوى غير مشفّر أو كليهما. يتم تضمين كليهما تلقائيًا.

ClientSideEncryptedOption

إذا كانت مؤسستك تستخدم ميزة التشفير من جهة العميل في Google Workspace، تشير هذه الحالة إلى حالة تشفير المحتوى.

عمليات التعداد
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED لم يتم تحديد حالة التشفير. تشمل النتائج محتوًى مشفَّرًا من جهة العميل ومحتوى غير مشفَّر.
CLIENT_SIDE_ENCRYPTED_OPTION_ANY ضمِّن كلاً من المحتوى المشفَّر من جهة العميل والمحتوى غير المشفَّر من جهة العميل في النتائج.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED تضمين المحتوى المشفَّر من جهة العميل فقط
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED يمكنك تضمين المحتوى غير المشفّر فقط.

DriveOptions

خيارات إضافية للبحث في Drive

تمثيل JSON 
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
الحقول
versionDate

string (Timestamp format)

يمكنك البحث في النسخة الحالية من ملف Drive، ولكن تصدير محتوى آخر نسخة تم حفظها قبل الساعة 12:00 صباحًا بالتوقيت العالمي المنسق (UTC) في التاريخ المحدّد. أدخِل التاريخ بالتوقيت العالمي المنسّق.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
includeTeamDrives
(deprecated)

boolean

اضبطها على "صحيح" لتضمين مساحة التخزين السحابي المشتركة.
includeSharedDrives

boolean

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

enum (ClientSideEncryptedOption)

يمكنك تحديد ما إذا كانت النتائج تتضمن فقط المحتوى المشفَّر باستخدام التشفير من جهة العميل في Google Workspace أو المحتوى غير المشفَّر فقط أو كليهما. يتم ضبط الإعدادات التلقائية على كلتيهما. تتوفّر هذه الميزة حاليًا في Drive.

HangoutsChatOptions

خيارات إضافية للبحث في Google Chat

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

boolean

لعمليات البحث حسب الحساب أو الوحدة التنظيمية، اضبط القيمة على true لتضمين الغرف.

VoiceOptions

خيارات إضافية للبحث الصوتي

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

enum (VoiceCoveredData)

أنواع البيانات المطلوب البحث فيها

CalendarOptions

خيارات إضافية للبحث في "تقويم Google"

تمثيل JSON 
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
الحقول
locationQuery[]

string

يطابق فقط الأحداث التي يحتوي موقعها على جميع الكلمات في المجموعة المحددة. إذا كانت السلسلة تحتوي على عبارات ذات علامتَي اقتباس، لن تتطابق هذه الطريقة إلا مع الأحداث التي يحتوي موقعها على العبارة نفسها. ويتم اعتبار الإدخالات في المجموعة في "و".

مثال على تقسيم الكلمات: ["نيوزيلندا"] مقابل ["New","Zealand"] "نيوزيلندا": مطابق لكل من "نيوزيلندا ونيوزيلندا": تتطابق مع ما يلي فقط
peopleQuery[]

string

يطابق فقط الأحداث التي يحتوي ضيوفها على جميع الكلمات في المجموعة المحددة. ويتم اعتبار الإدخالات في المجموعة في "و".
minusWords[]

string

يطابق فقط الأحداث التي لا تحتوي على أي من الكلمات في المجموعة المحدّدة في العنوان أو الوصف أو الموقع الجغرافي أو الضيوف. ويتم اعتبار الإدخالات في المجموعة بالصيغة "أو".
responseStatuses[]

enum (AttendeeResponse)

يطابق فقط الأحداث التي قدَّم لها الوصيّ أحد هذه الردود. إذا كانت المجموعة فارغة أو تحتوي على ATTENDEE_RESPONSE_UNSPECIFIED، لن يتم تطبيق أي فلاتر على الردود.
versionDate

string (Timestamp format)

يمكنك البحث في النسخة الحالية من حدث "تقويم Google"، ولكن تصدير محتوى آخر نسخة تم حفظها قبل الساعة 12:00 صباحًا بالتوقيت العالمي المنسق (UTC) في التاريخ المحدّد. أدخِل التاريخ بالتوقيت العالمي المنسّق.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

AttendeeResponse

ردّ المستخدم على دعوة

عمليات التعداد
ATTENDEE_RESPONSE_UNSPECIFIED لم يتم تحديد ردّ الضيف. في حال ضبط هذا الإعداد، لن يتم فلترة الردود، وسيتم تجاهل جميع ردود الضيوف الأخرى التي تشكّل جزءًا من خيارات طلب البحث.
ATTENDEE_RESPONSE_NEEDS_ACTION تمت دعوة المشارك ولكنه لم يردّ بعد.
ATTENDEE_RESPONSE_ACCEPTED يخطط المشارك للحضور.
ATTENDEE_RESPONSE_DECLINED المشارك لا يخطط للحضور.
ATTENDEE_RESPONSE_TENTATIVE يتوقع المشارك أن يحضر.