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)

เวลาเริ่มต้นสำหรับคำค้นหา ระบุเป็น GMT ระบบจะปัดเศษค่าเป็น 00:00 น. ในวันที่ที่ระบุ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
endTime

string (Timestamp format)

เวลาสิ้นสุดของคำค้นหา ระบุเป็น GMT ระบบจะปัดเศษค่าเป็น 00:00 น. ในวันที่ที่ระบุ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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" โปรดดูรายชื่อเขตเวลาในเขตเวลา โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ห้องนิรภัยใช้เขตเวลาที่ศูนย์ช่วยเหลือของห้องนิรภัย
ฟิลด์การรวม 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 คือ ROOM (อ่านอย่างเดียว)
sitesUrlInfo

object (SitesUrlInfo)

ต้องระบุเมื่อ SearchMethod คือ SITES_URL
ฟิลด์การรวม corpus_options_field ตัวเลือกการค้นหาเพิ่มเติมสำหรับบริการเฉพาะ corpus_options_field ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
mailOptions

object (MailOptions)

ตั้งค่าตัวเลือกเฉพาะการค้นหาของ Gmail
driveOptions

object (DriveOptions)

ตั้งค่าตัวเลือกการค้นหาในไดรฟ์โดยเฉพาะ
hangoutsChatOptions

object (HangoutsChatOptions)

ตั้งค่าตัวเลือกเฉพาะการค้นหาของ Chat (อ่านอย่างเดียว)
voiceOptions

object (VoiceOptions)

ตั้งค่าตัวเลือกเฉพาะสำหรับการค้นหาด้วยเสียง
calendarOptions

object (CalendarOptions)

ตั้งค่าตัวเลือกเฉพาะการค้นหาปฏิทิน

DataScope

แหล่งที่มาของข้อมูลที่จะค้นหา

Enum
DATA_SCOPE_UNSPECIFIED ไม่ได้ระบุแหล่งข้อมูล
ALL_DATA ข้อมูลที่มีทั้งหมด
HELD_DATA ข้อมูลที่คงไว้ชั่วคราวเท่านั้น
UNPROCESSED_DATA เฉพาะข้อมูลที่ยังไม่ได้ประมวลผลโดยห้องนิรภัย (Gmail และ Groups เท่านั้น)

SearchMethod

ประเภทเอนทิตีสำหรับการค้นหา

Enum
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 ระบุไว้ ขีดจำกัดการส่งออกพื้นที่ใน Chat คือ 500 รายการต่อคำขอ

SitesUrlInfo

URL ของเว็บไซต์ที่เผยแพร่แล้วของ Google Sites แบบใหม่ที่จะค้นหา

การแสดง JSON 
{
  "urls": [
    string
  ]
}
ช่อง
urls[]

string

รายการ URL ของเว็บไซต์ที่เผยแพร่

TeamDriveInfo

ไดรฟ์ของทีมเพื่อค้นหา

การแสดง JSON 
{
  "teamDriveIds": [
    string
  ]
}
ช่อง
teamDriveIds[]
(deprecated)

string

รายการรหัสไดรฟ์ของทีมตามที่กำหนดโดย Drive API

MailOptions

ตัวเลือกเพิ่มเติมสำหรับการค้นหาใน Gmail

การแสดง JSON 
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
ช่อง
excludeDrafts

boolean

ตั้งค่าเป็น true เพื่อไม่รวมข้อความร่าง
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

ระบุว่าผลลัพธ์ควรมีเนื้อหาที่เข้ารหัส เนื้อหาที่ไม่ได้เข้ารหัส หรือทั้ง 2 อย่าง ค่าเริ่มต้นคือรวมทั้ง 2 อย่าง

ClientSideEncryptedOption

หากองค์กรของคุณใช้การเข้ารหัสฝั่งไคลเอ็นต์ของ Google Workspace สถานะการเข้ารหัสของเนื้อหา

Enum
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED ไม่ได้ระบุสถานะการเข้ารหัส ผลลัพธ์จะมีทั้งเนื้อหาที่เข้ารหัสฝั่งไคลเอ็นต์และไม่ได้เข้ารหัส
CLIENT_SIDE_ENCRYPTED_OPTION_ANY มีทั้งเนื้อหาที่เข้ารหัสฝั่งไคลเอ็นต์และไม่ได้เข้ารหัสในผลการค้นหา
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED รวมเนื้อหาที่เข้ารหัสฝั่งไคลเอ็นต์เท่านั้น
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED รวมเฉพาะเนื้อหาที่ไม่ได้เข้ารหัสเท่านั้น

DriveOptions

ตัวเลือกเพิ่มเติมสำหรับการค้นหาในไดรฟ์

การแสดง JSON 
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
ช่อง
versionDate

string (Timestamp format)

ค้นหาเวอร์ชันปัจจุบันของไฟล์ในไดรฟ์ แต่ส่งออกเนื้อหาของเวอร์ชันล่าสุดที่บันทึกไว้ก่อนเวลา 00:00 น. ตามเขตเวลา UTC ในวันที่ที่ระบุ ป้อนวันที่ในเขตเวลา UTC

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
includeTeamDrives
(deprecated)

boolean

ตั้งค่าเป็น "จริง" เพื่อรวมไดรฟ์ของทีม
includeSharedDrives

boolean

ตั้งค่าเป็น true เพื่อรวมไดรฟ์ที่แชร์
clientSideEncryptedOption

enum (ClientSideEncryptedOption)

กำหนดว่าผลลัพธ์จะมีเฉพาะเนื้อหาที่เข้ารหัสด้วยเนื้อหาการเข้ารหัสฝั่งไคลเอ็นต์ของ Google Workspace เฉพาะเนื้อหาที่ไม่เข้ารหัส หรือทั้ง 2 อย่าง ค่าเริ่มต้นคือทั้ง 2 แบบ ขณะนี้รองรับไดรฟ์

HangoutsChatOptions

ตัวเลือกเพิ่มเติมสำหรับการค้นหาใน Google Chat

การแสดง JSON 
{
  "includeRooms": boolean
}
ช่อง
includeRooms

boolean

สำหรับการค้นหาตามบัญชีหรือหน่วยขององค์กร ให้ตั้งค่าเป็น true เพื่อรวมห้องแชท

VoiceOptions

ตัวเลือกเพิ่มเติมสำหรับการค้นหาด้วยเสียง

การแสดง JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
ช่อง
coveredData[]

enum (VoiceCoveredData)

ประเภทข้อมูลที่จะค้นหา

CalendarOptions

ตัวเลือกเพิ่มเติมสำหรับการค้นหาปฏิทิน

การแสดง JSON 
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
ช่อง
locationQuery[]

string

จับคู่เฉพาะเหตุการณ์ซึ่งสถานที่ตั้งมีคำทั้งหมดในชุดที่ระบุ หากสตริงมีวลีที่ยกมา เมธอดนี้จะจับคู่เฉพาะเหตุการณ์ซึ่งมีวลีที่ตรงกับตำแหน่งนั้นเท่านั้น รายการต่างๆ ในชุดจะถือว่าเป็น "and"

ตัวอย่างการแยกคำ: ["New Zealand"] กับ ["New","Zealand"] "New Zealand": จับคู่กับทั้ง "นิวซีแลนด์และดีกว่า": จับคู่เฉพาะทีหลัง
peopleQuery[]

string

จับคู่เฉพาะกิจกรรมที่ผู้เข้าร่วมมีคำทั้งหมดในชุดที่ระบุ รายการต่างๆ ในชุดจะถือว่าเป็น "and"
minusWords[]

string

จับคู่เฉพาะกิจกรรมที่ไม่มีคำใดๆ ในชุดที่ระบุในชื่อ คำอธิบาย สถานที่ หรือผู้เข้าร่วม รายการต่างๆ ในชุดจะถือว่าเป็น "or"
responseStatuses[]

enum (AttendeeResponse)

จับคู่เฉพาะเหตุการณ์ที่ผู้ปกป้องรักษาข้อมูลให้คำตอบข้อใดข้อหนึ่งต่อไปนี้ หากชุดนี้ว่างเปล่าหรือมี ATTENDEE_RESPONSE_UNSPECIFIED จะไม่มีการกรองคำตอบ
versionDate

string (Timestamp format)

ค้นหากิจกรรมในปฏิทินเวอร์ชันปัจจุบัน แต่ส่งออกเนื้อหาของเวอร์ชันล่าสุดที่บันทึกไว้ก่อนเวลา 00:00 น. ตามเขตเวลา UTC ในวันที่ที่ระบุ ป้อนวันที่ในเขตเวลา UTC

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

AttendeeResponse

ผู้ใช้ตอบกลับคำเชิญ

Enum
ATTENDEE_RESPONSE_UNSPECIFIED ไม่ได้ระบุคำตอบของผู้เข้าร่วม หากตั้งค่านี้ ไม่มีการกรองคำตอบ ระบบจะไม่สนใจคำตอบของผู้เข้าร่วมคนอื่นๆ ทั้งหมดที่เป็นส่วนหนึ่งของตัวเลือกการค้นหา
ATTENDEE_RESPONSE_NEEDS_ACTION ผู้เข้าร่วมได้รับเชิญแล้ว แต่ยังไม่ได้ตอบกลับ
ATTENDEE_RESPONSE_ACCEPTED ผู้เข้าร่วมวางแผนที่จะเข้าร่วม
ATTENDEE_RESPONSE_DECLINED ผู้เข้าร่วมไม่ได้วางแผนที่จะเข้าร่วม
ATTENDEE_RESPONSE_TENTATIVE ผู้เข้าร่วมอาจต้องเข้าร่วม