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,

  "accountInfo": {
    object (AccountInfo)
  },
  "orgUnitInfo": {
    object (OrgUnitInfo)
  },
  "sharedDriveInfo": {
    object (SharedDriveInfo)
  },
  "hangoutsChatInfo": {
    object (HangoutsChatInfo)
  },
  "sitesUrlInfo": {
    object (SitesUrlInfo)
  },
  "driveDocumentInfo": {
    object (DriveDocumentInfo)
  }

  "mailOptions": {
    object (MailOptions)
  },
  "driveOptions": {
    object (DriveOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatOptions)
  },
  "voiceOptions": {
    object (VoiceOptions)
  },
  "calendarOptions": {
    object (CalendarOptions)
  },
  "geminiOptions": {
    object (GeminiOptions)
  },
  "geminiInWorkspaceOptions": {
    object (GeminiInWorkspaceOptions)
  }
}
ช่อง
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 น. ของวันที่ระบุ

ใช้ 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)

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

ใช้ 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"
teamDriveInfo
(deprecated)

object (TeamDriveInfo)

ต้องระบุเมื่อ SearchMethod เป็น TEAM_DRIVE
timeZone

string

ชื่อเขตเวลา โดยควรเป็นชื่อ IANA TZ เช่น "America/Los_Angeles" ดูรายชื่อเขตเวลาได้ที่เขตเวลา ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ห้องนิรภัยใช้เขตเวลาได้ที่ศูนย์ช่วยเหลือของห้องนิรภัย
ระบุรายละเอียดของเอนทิตีที่จะค้นหาเมื่อจำเป็น ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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
driveDocumentInfo

object (DriveDocumentInfo)

ต้องระบุเมื่อ SearchMethod เป็น DRIVE_DOCUMENT
สิ้นสุดฟิลด์ที่แยกกัน
ตัวเลือกการค้นหาเพิ่มเติมสำหรับบริการที่เฉพาะเจาะจง ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
mailOptions

object (MailOptions)

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

object (DriveOptions)

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

object (HangoutsChatOptions)

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

object (VoiceOptions)

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

object (CalendarOptions)

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

object (GeminiOptions)

ตั้งค่าตัวเลือกเฉพาะการค้นหาของแอป Gemini
geminiInWorkspaceOptions

object (GeminiInWorkspaceOptions)

ตั้งค่าตัวเลือกเฉพาะการค้นหาของ Gemini ใน Workspace
สิ้นสุดฟิลด์ที่แยกกัน

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
DRIVE_DOCUMENT ดึงข้อมูลเอกสารที่ระบุใน DriveDocumentInfo

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 Sites แบบใหม่ที่จะค้นหา

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

string

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

DriveDocumentInfo

เอกสารในไดรฟ์ที่จะค้นหา

การแสดง JSON 
{

  "documentIds": {
    object (DriveDocumentIds)
  }
}
ช่อง
รูปแบบในการเรียกข้อมูลเอกสารในไดรฟ์ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
documentIds

object (DriveDocumentIds)

ระบุเอกสารในไดรฟ์ตามรหัสเอกสาร
สิ้นสุดฟิลด์ที่แยกกัน

DriveDocumentIds

ระบุเอกสารในไดรฟ์ตามรหัสเอกสาร

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

string

ต้องระบุ รายการรหัสเอกสารในไดรฟ์

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),
  "sharedDrivesOption": enum (SharedDrivesOption)
}
ช่อง
versionDate

string (Timestamp format)

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

ใช้ 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"
includeTeamDrives
(deprecated)

boolean

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

boolean

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

enum (ClientSideEncryptedOption)

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

enum (SharedDrivesOption)

ไม่บังคับ ตัวเลือกในการรวมหรือยกเว้นเอกสารในไดรฟ์ที่แชร์ เราขอแนะนำให้ใช้ช่องนี้แทน includeSharedDrives ช่องนี้จะลบล้าง includeSharedDrives และ includeTeamDrives เมื่อตั้งค่าไว้

SharedDrivesOption

ตัวเลือกประเภทเอกสารในไดรฟ์ที่แชร์ที่จะรวม

Enum
SHARED_DRIVES_OPTION_UNSPECIFIED ไม่ได้ระบุตัวเลือกไดรฟ์ที่แชร์
NOT_INCLUDED หากทรัพยากรอยู่ในไดรฟ์ที่แชร์ ระบบจะไม่รวมทรัพยากรดังกล่าวไว้ในการค้นหา
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER ทรัพยากรในไดรฟ์ที่แชร์จะรวมอยู่เฉพาะในกรณีที่บัญชีเป็นผู้ทำงานร่วมกันในทรัพยากร แต่ไม่ได้เป็นสมาชิกของไดรฟ์ที่แชร์ ซึ่งจะแมปกับตัวเลือก "รวมอยู่เฉพาะเมื่อมีการแชร์เอกสารโดยตรง (ไม่ใช่เนื่องจากการเป็นสมาชิกไดรฟ์ที่แชร์)" ใน UI ของห้องนิรภัย (ก่อนหน้านี้ "includeSharedDrives" ปิดอยู่)
INCLUDED ทรัพยากรในไดรฟ์ที่แชร์จะรวมอยู่ในการค้นหา (ก่อนหน้านี้คือ "includeSharedDrives" เปิดอยู่)

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

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

ตัวอย่างการแยกคำ: ["New Zealand"] เทียบกับ ["New","Zealand"] "New Zealand": จับคู่กับทั้ง "New and better Zealand": จับคู่กับรายการหลังเท่านั้น
peopleQuery[]

string

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

string

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

enum (AttendeeResponse)

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

string (Timestamp format)

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

ใช้ 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"

AttendeeResponse

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

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

GeminiOptions

ประเภทนี้ไม่มีช่อง

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

GeminiInWorkspaceOptions

ประเภทนี้ไม่มีช่อง

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