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)
  },
  "geminiInWorkspaceOptions": {
    object (GeminiInWorkspaceOptions)
  }
}
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'ın yerini alır. searchMethod, 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 00: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 00: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ı. "America/Los_Angeles" gibi bir IANA TZ adı olmalıdır. Saat dilimi adlarının listesi için Saat Dilimi bölümüne bakın. Apps Kasası'nın saat dilimlerini nasıl kullandığı hakkında daha fazla bilgi için Apps Kasası Yardım Merkezi'ne göz atın.

Gerektiğinde, aranacak varlıkların ayrıntılarını belirtir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
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 gereklidir. (salt okunur)

sitesUrlInfo

object (SitesUrlInfo)

SearchMethod, SITES_URL olduğunda gereklidir.

driveDocumentInfo

object (DriveDocumentInfo)

SearchMethod, DRIVE_DOCUMENT olduğunda gereklidir.

Birbirini hariç tutan alanların sonu.
Belirli hizmetler için ek arama seçenekleri. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
mailOptions

object (MailOptions)

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

driveOptions

object (DriveOptions)

Drive'da aramaya özel seçenekleri ayarlama

hangoutsChatOptions

object (HangoutsChatOptions)

Chat'te aramaya özel seçenekleri ayarlayın. (salt okunur)

voiceOptions

object (VoiceOptions)

Sesli aramayla ilgili seçenekleri ayarlayın.

calendarOptions

object (CalendarOptions)

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

geminiOptions

object (GeminiOptions)

Gemini uygulamasının aramaya özel seçeneklerini ayarlama

geminiInWorkspaceOptions

object (GeminiInWorkspaceOptions)

Workspace'te Gemini'ın aramaya özel seçeneklerini ayarlayın.

Birbirini hariç tutan alanların sonu.

DataScope

Aranacak veri kaynağıdır.

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 reddedilir.
ACCOUNT AccountInfo'da belirtilen hesapların verilerini arayın.
ORG_UNIT OrgUnitInfo'da belirtilen kuruluş birimindeki tüm hesapların verilerini arayın.
TEAM_DRIVE

teamDriveInfo'da belirtilen Ortak Drive'daki verileri arayın.

ENTIRE_ORG Kuruluştaki tüm hesapların verilerinde arama yapma 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'da belirtilen yayınlanmış site URL'lerine göre site arayın.
SHARED_DRIVE SharedDriveInfo'da belirtilen ortak Drive'lardaki dosyaları arar.
DRIVE_DOCUMENT DriveDocumentInfo'da belirtilen dokümanları alır.

AccountInfo

Aranacak hesaplar

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

string

Aranacak hesap 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ından dışa aktarma sınırı vardır.

SitesUrlInfo

Aranacak yeni Google Sites sitelerinin 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
Drive dokümanlarının alınacağı biçim. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
documentIds

object (DriveDocumentIds)

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

Birbirini hariç tutan alanların sonu.

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 Ortak Drive kimliklerinin listesi.

MailOptions

Gmail'de 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çerip içermeyeceğ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 belirtilmemiş. 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çerikleri dahil edin.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED Yalnızca istemci tarafında şifrelenmiş içerikleri dahil edin.
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED Yalnızca şifrelenmemiş içerikleri dahil etme

DriveOptions

Drive araması 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 mevcut 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'ını dahil etmek için true değerine 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çerikleri mi, yalnızca şifrelenmemiş içerikleri mi yoksa her ikisini mi içereceğini belirleyin. Varsayılan olarak her ikisi de seçilidir. Şu anda Drive'da desteklenmektedir.

sharedDrivesOption

enum (SharedDrivesOption)

İsteğe bağlıdır. Ortak Drive'lardaki dokümanları dahil etme veya hariç tutma seçenekleri. includeSharedDrives yerine bu alanı 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 aramaya dahil edilmez.
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER Ortak Drive kaynakları, yalnızca hesabın bir kaynakta 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ğiyle eşleşir. (Önceden "includeSharedDrives" kapalıydı)
INCLUDED Ortak Drive'lardaki kaynaklar aramaya dahil edilir. (Önceden "includeSharedDrives" açık)

HangoutsChatOptions

Google Chat araması 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 değerini 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, belirtilen gruptaki tüm kelimeleri içeren etkinliklerle eşleşir. Dize tırnak içine alınmış kelime öbekleri içeriyorsa bu yöntem yalnızca konumu tam kelime öbeğini içeren etkinliklerle eşleşir. Kümedeki girişler "ve" olarak değerlendirilir.

Kelime bölme örneği: ["New Zealand"] ve ["New","Zealand"] "New Zealand": her ikisiyle de eşleşir "New and better Zealand": yalnızca ikincisiyle eşleşir

peopleQuery[]

string

Yalnızca katılımcıları, belirtilen gruptaki tüm kelimeleri içeren etkinliklerle eşleşir. Kümedeki girişler "ve" olarak değerlendirilir.

minusWords[]

string

Yalnızca başlık, açıklama, konum veya katılımcılar alanında belirtilen gruptaki kelimelerden hiçbirini içermeyen etkinliklerle eşleşir. Kümedeki girişler "veya" olarak kabul edilir.

responseStatuses[]

enum (AttendeeResponse)

Yalnızca, veri sorumlusunun 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 davete 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ı katılmayı planlamıyor.
ATTENDEE_RESPONSE_TENTATIVE Katılımcı, toplantıya katılmayı planlıyor.

GeminiOptions

Bu türün alanı yok.

Gemini uygulamasında arama için ek seçenekler

GeminiInWorkspaceOptions

Bu türün alanı yok.

Workspace'te Gemini ile arama için ek seçenekler