Query

Arama ve dışa aktarma için kullanılan sorgu tanımı.

JSON gösterimi
{
  "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)
  }
}
Alanlar
corpus

enum (CorpusType)

Aranacak Google Workspace hizmeti.

dataScope

enum (DataScope)

Aranacak veri kaynağı.

searchMethod
(deprecated)

enum (SearchMethod)

Kullanılacak arama yöntemi.

method

enum (SearchMethod)

Aranacak varlık. Bu alan, ortak Drive'ları desteklemek için searchMethod alanının yerini alır. searchMethod değeri TEAM_DRIVE olduğunda bu alanın yanıtı SHARED_DRIVE olur.

terms

string

Arama sonuçlarını filtrelemek için hizmete özel arama operatörleri.

startTime

string (Timestamp format)

Arama sorgusunun başlangıç zamanı. GMT olarak belirtin. Değer, belirtilen tarihte saat 12:00'a yuvarlanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Arama sorgusunun bitiş zamanı. GMT olarak belirtin. Değer, belirtilen tarihte saat 12:00'a yuvarlanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

teamDriveInfo
(deprecated)

object (TeamDriveInfo)

SearchMethod, TEAM_DRIVE olduğunda zorunludur.

timeZone

string

Saat dilimi adı. Bu, "America/Los_Angeles" gibi bir IANA TZ adı olmalıdır. Saat dilimi adlarının listesi için Saat Dilimi başlıklı makaleyi inceleyin. Apps Kasası'nın saat dilimlerini kullanma şekli hakkında daha fazla bilgi için Apps Kasası Yardım Merkezi'ne bakın.

search_method_field birleşik alanı. Gerekli olduğunda, aranacak öğelerin ayrıntıları search_method_field yalnızca aşağıdakilerden biri olabilir:
accountInfo

object (AccountInfo)

SearchMethod, ACCOUNT olduğunda zorunludur.

orgUnitInfo

object (OrgUnitInfo)

SearchMethod ORG_UNIT olduğunda zorunludur.

sharedDriveInfo

object (SharedDriveInfo)

SearchMethod, SHARED_DRIVE olduğunda zorunludur.

hangoutsChatInfo

object (HangoutsChatInfo)

SearchMethod, ROOM olduğunda zorunludur. (salt okunur)

sitesUrlInfo

object (SitesUrlInfo)

SearchMethod, SITES_URL olduğunda gereklidir.

driveDocumentInfo

object (DriveDocumentInfo)

SearchMethod, DRIVE_DOCUMENT olduğunda zorunludur.

corpus_options_field birleşik alanı. Belirli hizmetler için ek arama seçenekleri. corpus_options_field aşağıdakilerden yalnızca biri olabilir:
mailOptions

object (MailOptions)

Gmail'de aramaya özel seçenekleri ayarlayın.

driveOptions

object (DriveOptions)

Drive'da arama için özel seçenekler belirleyin.

hangoutsChatOptions

object (HangoutsChatOptions)

Chat arama işlemine özel seçenekleri ayarlayın. (salt okunur)

voiceOptions

object (VoiceOptions)

Sesli arama ile ilgili seçenekleri ayarlayın.

calendarOptions

object (CalendarOptions)

Takvim'de aramayla ilgili seçenekleri ayarlayın.

geminiOptions

object (GeminiOptions)

Gemini'a özgü arama seçeneklerini ayarlayın.

DataScope

Aranacak verilerin kaynağı.

Sıralamalar
DATA_SCOPE_UNSPECIFIED Veri kaynağı belirtilmedi.
ALL_DATA Mevcut tüm veriler.
HELD_DATA Yalnızca muhafazaya alınan veriler.
UNPROCESSED_DATA Yalnızca Apps Kasası tarafından henüz işlenmemiş veriler. (Yalnızca Gmail ve Gruplar)

SearchMethod

Arama için varlık türü.

Sıralamalar
SEARCH_METHOD_UNSPECIFIED Bir arama yöntemi belirtilmelidir, aksi takdirde istek reddedilir.
ACCOUNT AccountInfo içinde belirtilen hesapların verilerini arayın.
ORG_UNIT OrgUnitInfo içinde belirtilen kuruluş birimindeki tüm hesapların verilerinde arama yapın.
TEAM_DRIVE

teamDriveInfo içinde belirtilen Ekip Drive'daki verilerde arama yapın.

ENTIRE_ORG Kuruluştaki tüm hesapların verilerinde arama yapın. Yalnızca Gmail'de desteklenir. Belirtildiğinde AccountInfo veya OrgUnitInfo'yu belirtmeniz gerekmez.
ROOM HangoutsChatInfo'da belirtilen Chat alanlarındaki mesajları arama.
SITES_URL SitesUrlInfo içinde belirtilen yayınlanmış site URL'lerine göre siteleri arayın.
SHARED_DRIVE SharedDriveInfo içinde belirtilen ortak drive'lardaki dosyaları arayın.
DRIVE_DOCUMENT DriveDocumentInfo'da belirtilen dokümanları alın.

AccountInfo

Aranacak hesaplar

JSON gösterimi
{
  "emails": [
    string
  ]
}
Alanlar
emails[]

string

Aranacak hesaplar grubu.

OrgUnitInfo

Aranacak kuruluş birimi

JSON gösterimi
{
  "orgUnitId": string
}
Alanlar
orgUnitId

string

Admin SDK Directory API tarafından sağlanan, aranacak kuruluş biriminin adı.

SharedDriveInfo

Aranacak ortak drive'lar

JSON gösterimi
{
  "sharedDriveIds": [
    string
  ]
}
Alanlar
sharedDriveIds[]

string

Drive API tarafından sağlanan ortak drive kimliklerinin listesi.

HangoutsChatInfo

Aranacak Chat alanları

JSON gösterimi
{
  "roomId": [
    string
  ]
}
Alanlar
roomId[]

string

Chat API tarafından sağlanan Chat alanı kimliklerinin listesi. İstek başına 500 Chat alanı dışa aktarabilirsiniz.

SitesUrlInfo

Aranacak yeni Google Sites'ın yayınlanan site URL'leri

JSON gösterimi
{
  "urls": [
    string
  ]
}
Alanlar
urls[]

string

Yayınlanan site URL'lerinin listesi.

DriveDocumentInfo

Aranacak Drive dokümanları.

JSON gösterimi
{

  "documentIds": {
    object (DriveDocumentIds)
  }
}
Alanlar
identifier birleşik alanı. Drive dokümanlarını almak için kullanılan biçim. identifier aşağıdakilerden yalnızca biri olabilir:
documentIds

object (DriveDocumentIds)

Drive dokümanlarını doküman kimliğine göre belirtin.

DriveDocumentIds

Drive dokümanlarını doküman kimliğine göre belirtin.

JSON gösterimi
{
  "ids": [
    string
  ]
}
Alanlar
ids[]

string

Zorunlu. Drive dokümanı kimliklerinin listesi.

TeamDriveInfo

Aranacak Ekip Drive'ları

JSON gösterimi
{
  "teamDriveIds": [
    string
  ]
}
Alanlar
teamDriveIds[]
(deprecated)

string

Drive API tarafından sağlanan ekip sürücüsü kimliklerinin listesi.

MailOptions

Gmail arama için ek seçenekler

JSON gösterimi
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
Alanlar
excludeDrafts

boolean

Taslakları hariç tutmak için true olarak ayarlayın.

clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Sonuçların şifrelenmiş içerik, şifrelenmemiş içerik veya her ikisini de içermesi gerekip gerekmediğini belirtir. Varsayılan olarak her ikisi de dahil edilir.

ClientSideEncryptedOption

Kuruluşunuz Google Workspace istemci tarafı şifreleme kullanıyorsa içeriğin şifreleme durumu

Sıralamalar
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED Şifreleme durumu belirtilmedi. Sonuçlar hem istemci tarafında şifrelenmiş hem de şifrelenmemiş içerikleri kapsar.
CLIENT_SIDE_ENCRYPTED_OPTION_ANY Sonuçlara hem istemci tarafında şifrelenmiş hem de şifrelenmemiş içerik ekleyin.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED Yalnızca istemci tarafında şifrelenmiş içerik ekleyin.
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED Yalnızca şifrelenmemiş içeriği dahil edin.

DriveOptions

Drive arama için ek seçenekler.

JSON gösterimi
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption),
  "sharedDrivesOption": enum (SharedDrivesOption)
}
Alanlar
versionDate

string (Timestamp format)

Drive dosyasının geçerli sürümünde arama yapın ancak belirtilen tarihte saat 00:00'dan (UTC) önce kaydedilen son sürümün içeriğini dışa aktarın. Tarihi UTC olarak girin.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

includeTeamDrives
(deprecated)

boolean

Ekip Drive'ı dahil etmek için true olarak ayarlayın.

includeSharedDrives
(deprecated)

boolean

Ortak drive'ları dahil etmek için true olarak ayarlayın.

clientSideEncryptedOption

enum (ClientSideEncryptedOption)

Sonuçların yalnızca Google Workspace istemci tarafı şifreleme ile şifrelenmiş içeriği mi, yalnızca şifrelenmemiş içeriği mi yoksa her ikisini de mi içereceğini ayarlayın. Varsayılan olarak her ikisi de seçilidir. Şu anda Drive'da desteklenmektedir.

sharedDrivesOption

enum (SharedDrivesOption)

İsteğe bağlı. Ortak Drive'lardaki dokümanları dahil etme veya hariç tutma seçenekleri. Bu alanı includeSharedDrives yerine kullanmanızı öneririz. Bu alan, ayarlandığında includeSharedDrives ve includeTeamDrives'ı geçersiz kılar.

SharedDrivesOption

Dahil edilecek ortak Drive dokümanlarının türüyle ilgili seçenek.

Sıralamalar
SHARED_DRIVES_OPTION_UNSPECIFIED Ortak drive seçeneği belirtilmedi.
NOT_INCLUDED Bir kaynak ortak Drive'da yer alıyorsa arama sonuçlarına dahil edilmez.
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER Ortak Drive kaynakları yalnızca hesabın bir kaynağın ortak çalışanı olduğu ancak ortak Drive'ın üyesi olmadığı durumlarda dahil edilir. Bu, Apps Kasası kullanıcı arayüzündeki "Yalnızca dokümanlar doğrudan paylaşılırsa (ortak Drive üyeliği nedeniyle değil) dahil edilir" seçeneğine karşılık gelir. (Önceden "includeSharedDrives" kapalıydı)
INCLUDED Ortak Drive'lardaki kaynaklar aramaya dahil edilir. (Önceden "includeSharedDrives" on)

HangoutsChatOptions

Google Chat arama için ek seçenekler

JSON gösterimi
{
  "includeRooms": boolean
}
Alanlar
includeRooms

boolean

Hesaba veya kuruluş birimine göre yapılan aramalarda odaları dahil etmek için true olarak ayarlayın.

VoiceOptions

Sesli arama için ek seçenekler

JSON gösterimi
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Alanlar
coveredData[]

enum (VoiceCoveredData)

Aranacak veri türleri

CalendarOptions

Takvim'de arama için ek seçenekler

JSON gösterimi
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
Alanlar
locationQuery[]

string

Yalnızca konumu, verilen gruptaki tüm kelimeleri içeren etkinliklerle eşleşir. Dize, tırnak içine alınmış ifadeler içeriyorsa bu yöntem yalnızca konumu tam olarak bu ifadeyi içeren etkinliklerle eşleşir. Gruptaki girişler "ve" olarak kabul edilir.

Kelime bölme örneği: ["Yeni Zelanda"] ve ["Yeni","Zelanda"] "Yeni Zelanda": her ikisiyle de eşleşir "Yeni ve daha iyi Zelanda": yalnızca ikincisiyle eşleşir

peopleQuery[]

string

Yalnızca katılımcıları, verilen gruptaki tüm kelimeleri içeren etkinliklerle eşleşir. Gruptaki girişler "ve" olarak kabul edilir.

minusWords[]

string

Yalnızca başlık, açıklama, konum veya katılımcı alanlarında verilen kümedeki kelimelerden herhangi birini içermeyen etkinliklerle eşleşir. Gruptaki girişler "veya" olarak kabul edilir.

responseStatuses[]

enum (AttendeeResponse)

Yalnızca gözetimcinin bu yanıtlardan birini verdiği etkinlikleri eşleştirir. Küme boşsa veya ATTENDEE_RESPONSE_UNSPECIFIED içeriyorsa yanıtlarda filtreleme yapılmaz.

versionDate

string (Timestamp format)

Takvim etkinliğinin geçerli sürümünde arama yapın ancak belirtilen tarihte saat 00:00'dan (UTC) önce kaydedilen son sürümün içeriğini dışa aktarın. Tarihi UTC olarak girin.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

AttendeeResponse

Kullanıcının bir davetiyeye verdiği yanıt.

Sıralamalar
ATTENDEE_RESPONSE_UNSPECIFIED Katılımcı yanıtı belirtilmedi. Bu ayar belirlenirse yanıtlarda filtreleme yapılmaz ve sorgu seçeneklerinin parçası olan diğer tüm katılımcı yanıtları yoksayılır.
ATTENDEE_RESPONSE_NEEDS_ACTION Katılımcı davet edildi ancak henüz yanıt vermedi.
ATTENDEE_RESPONSE_ACCEPTED Katılımcı katılmayı planlıyor.
ATTENDEE_RESPONSE_DECLINED Katılımcı, etkinliğe katılmayı planlamıyordur.
ATTENDEE_RESPONSE_TENTATIVE Katılımcı, toplantıya katılmayı planlıyor.

GeminiOptions

Bu türde alan yok.

Gemini arama için ek seçenekler