Method: spaces.messages.search

string

Zorunlu. Arama sorgusu

Sorgu, sonuçları filtrelemek için kullanılan bir veya daha fazla arama anahtar kelimesi belirtebilir.

Ayrıca, aşağıdaki ileti alanlarını kullanarak da sonuçları filtreleyebilirsiniz:

• createTime: RFC-3339 biçiminde bir zaman damgasını kabul eder ve desteklenen karşılaştırma operatörleri şunlardır: < ve >=.
• sender.name: Gönderenin kaynak adı (users/{user}). Yalnızca = desteklenir. E-postayı {user} için takma ad olarak kullanabilirsiniz. Örneğin, users/example@gmail.com. Burada example@gmail.com, Google Chat kullanıcısının e-posta adresidir.
• space.name: İletinin yayınlandığı alanın kaynak adı. (spaces/{space}). Yalnızca = desteklenir. Bu filtre ayarlanmazsa arama, kullanıcının alan üyesi olarak erişebildiği tüm doğrudan mesajlarda ve alanlarda gerçekleştirilir.
• space.display_name: : (var) operatörünü destekler ve alanları görünen adlarının kısmi eşleşmesine göre filtreler. Sonuçlar, en iyi beş alan eşleşmesiyle sınırlıdır. Örneğin, space.display_name:Project, görünen adlarında "Proje" kelimesini içeren ilk beş alandaki mesajları arar.
• attachment: Eklerin varlığını kontrol etmek için :* (herhangi bir) operatörünü destekler. attachment:* belirtilmişse yalnızca en az bir eki olan iletiler döndürülür.
• annotations.user_mentions.user.name: Bahsedilen kullanıcının kaynak adı (users/{user}). Yalnızca : (var) desteklenir. Örneğin: annotations.user_mentions.user.name:"users/1234567890" yalnızca belirtilen kullanıcıdan bahseden iletileri döndürür. Alternatif olarak, arayan kullanıcıdan bahseden iletileri filtrelemek için me takma adı kullanılabilir. Örneğin: annotations.user_mentions.user.name:users/me. Ayrıca, e-posta adresini {user} için takma ad olarak da kullanabilirsiniz. Örneğin, users/example@gmail.com.

Gelişmiş filtreleme için aşağıdaki işlevler de kullanılabilir:

• has_link(): Yalnızca ileti metninde en az bir köprü bulunan iletileri döndürür.
• is_unread(): Arayan kullanıcı tarafından okunan mesajları filtreler.

space.display_name filtresinin kullanılması için çağırma kimlik bilgilerinin aşağıdaki yetkilendirme kapsamlarından birini içermesi gerekir:

• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.spaces

is_unread() filtresinin kullanılması için çağırma kimlik bilgilerinin aşağıdaki yetkilendirme kapsamlarından birini içermesi gerekir:

• https://www.googleapis.com/auth/chat.users.readstate.readonly
• https://www.googleapis.com/auth/chat.users.readstate

Farklı alanlarda yalnızca AND operatörleri desteklenir. Geçerli bir örnek: sender.name = "users/1234567890" AND is_unread(). AND kelimesi isteğe bağlıdır ve atlanırsa varsayılır. Örneğin, sender.name = "users/1234567890" is_unread() geçerlidir ve önceki örnekle aynıdır. sender.name = "users/1234567890" OR is_unread() geçersiz bir örnektir. Bunun nedeni, OR sembolünün farklı alanlar arasında desteklenmemesidir.

Aynı alan içinde:

• createTime yalnızca AND değerini destekler ve yalnızca createTime >= "2022-01-01T00:00:00+00:00" AND createTime < "2023-01-01T00:00:00+00:00" gibi bir aralığı temsil etmek için kullanılabilir.
• sender.name yalnızca OR operatörünü destekler. Örneğin: sender.name = "users/1234567890" OR sender.name = "users/0987654321".
• space.name yalnızca OR operatörünü destekler. Örneğin: space.name = "spaces/ABCDEFGH" OR space.name = "spaces/QWERTYUI".
• space.display_name, AND ve OR operatörlerini destekler ancak ikisinin karışımını desteklemez. Örneğin: space.display_name:Project AND space.display_name:Tasks, hem Project hem de Tasks içeren görünen adlara sahip alanlardaki iletileri döndürürken space.display_name:Project OR space.display_name:Tasks, Project veya Tasks ya da her ikisini de içeren görünen adlara sahip alanlardaki iletileri döndürür.
• annotations.user_mentions.user.name, AND ve OR operatörlerini destekler ancak ikisinin karışımını desteklemez. Örneğin: annotations.user_mentions.user.name:"users/1234567890" AND annotations.user_mentions.user.name:"users/0987654321" yalnızca her iki kullanıcıdan da bahseden iletileri döndürürken annotations.user_mentions.user.name:"users/1234567890" OR annotations.user_mentions.user.name:"users/0987654321" her iki kullanıcıdan birinden veya her ikisinden de bahseden iletileri döndürür.

Aynı sorguda AND ve OR operatörleri birleştirilirken operatör önceliğini netleştirmek için parantez kullanılması gerekir. Örneğin: (sender.name="users/me" OR sender.name="users/123456") AND is_unread(). Aksi takdirde parantez kullanmak isteğe bağlıdır.

Aşağıdaki örnek sorgular geçerlidir:

"Pending reports" AND createTime >= "2023-01-01T00:00:00Z"

sender.name = "users/example@gmail.com"

annotations.user_mentions.user.name:"users/0987654321"

attachment:* AND space.name = "spaces/ABCDEFGH"

tasks AND is_unread() AND sender.name = "users/1234567890"

"things to do" "urgent"

(sender.name = "users/1234567890")
AND (createTime < "2023-05-01T00:00:00Z")

tasks AND space.name = "spaces/ABCDEFGH" AND has_link()

"project one" is_unread()

space.display_name:Project tasks

Maksimum sorgu uzunluğu 1.000 karakterdir.

Geçersiz sorgular, sunucu tarafından INVALID_ARGUMENT hatasıyla reddedilir.

integer

İsteğe bağlı. Döndürülecek maksimum sonuç sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Belirtilmemesi halinde en fazla 25 öğe döndürülür.

Maksimum değer 100'dür. 100'den büyük bir değer kullanırsanız bu değer otomatik olarak 100 olarak değiştirilir.

string

İsteğe bağlı. Önceki arama mesajları çağrısından alınan jeton. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalama yapılırken sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Diğer parametrelere farklı değerler iletmek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sonuç listesinin nasıl sıralandığı.

Sıralama için desteklenen özellikler şunlardır:

• createTime: Sonuçları iletinin oluşturulma zamanına göre sıralar. Varsayılan değer.
• relevance: Sonuçları alaka düzeyine göre sıralar.

Varsayılan sıralama createTime desc'dır. Sorgu başına (createTime veya relevance) yalnızca tek bir sipariş desteklenir. Yalnızca azalan sıra (desc) desteklenir ve sıra özelliğinden sonra belirtilmelidir.

enum (SearchMessagesView)

İsteğe bağlı. Ne tür arama sonuçları görünümünün döndürüleceğini belirtir. Varsayılan değer: SEARCH_MESSAGES_VIEW_BASIC.