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 อย่างหรือไม่ ค่าเริ่มต้นคือทั้งสอง ขณะนี้รองรับไดรฟ์

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

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

ตัวอย่างการแยกคำ: ["นิวซีแลนด์"] กับ ["นิวซีแลนด์", "ซีแลนด์"] "นิวซีแลนด์": จับคู่โดยทั้ง "นิวซีแลนด์และที่ดีกว่า": จับคู่โดยรายการถัดไปเท่านั้น
peopleQuery[]

string

จับคู่เฉพาะกิจกรรมที่ผู้เข้าร่วมมีคำทั้งหมดในชุดที่กำหนด ระบบจะพิจารณารายการในชุด "และ"
minusWords[]

string

จับคู่เฉพาะกิจกรรมที่ไม่มีคำใดๆ ในชุดคำที่ระบุในชื่อ คำอธิบาย สถานที่ หรือผู้เข้าร่วม ระบบจะถือว่ารายการในชุดเป็น "หรือ"
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 ผู้เข้าร่วมคาดหวังว่าจะเข้าร่วม