Package google.chat.v1

ButtonList

Düğme listesi.

ResponseType

Yalnızca giriş. Chat uygulaması yanıtının türü.

string

Yalnızca giriş. Kullanıcıların kimlik doğrulaması veya yapılandırma yapması için URL. (Yalnızca REQUEST_CONFIG yanıt türleri için.)

DialogAction

Yalnızca giriş. İletişim ile ilgili bir etkileşim etkinliğine verilen yanıt. ResponseType.Dialog ile birlikte gönderilmelidir.

UpdatedWidget

Yalnızca giriş. Güncellenen widget'ın yanıtı.

SelectionItem

SelectionItem nesneleri dizisi.

string

Güncellenen widget'ın kimliği. Kimlik, güncelleme isteğini tetikleyen widget'ın kimliğiyle eşleşmelidir.

SelectionItems

Widget otomatik tamamlama sonuçlarının listesi

Code

Durum kodu.

string

Kullanıcılara isteklerinin durumu hakkında gönderilecek mesaj. Ayarlanmamışsa status_code değerine göre genel bir mesaj gönderilir.

AnnotationType

Bu ek açıklamanın türü.

int32

Bu ek açıklamanın karşılık geldiği düz metin ileti gövdesinde alt dizenin uzunluğu.

int32

Bu ek açıklamanın karşılık geldiği düz metin mesaj gövdesinde başlangıç dizini (0 tabanlı, dahili).

UserMentionMetadata

Kullanıcının bahsedildiği meta veriler.

SlashCommandMetadata

Eğik çizgi komutunun meta verileri.

RichLinkMetadata

Zengin bağlantının meta verileri.

string

Yalnızca çıkış. GIF resmini barındıran URL.

string

İsteğe bağlı. Ekin kaynak adı (spaces/{space}/messages/{message}/attachments/{attachment} biçiminde).

string

Yalnızca çıkış. Tam yol değil, içeriğin orijinal dosya adı.

string

Yalnızca çıkış. Dosyanın içerik türü (MIME türü).

string

Yalnızca çıkış. Ekteki içeriği gerçek bir kullanıcıya önizlemek için kullanılması gereken küçük resim URL'si. Sohbet uygulamaları, ek içeriğini indirmek için bu URL'yi kullanmamalıdır.

string

Yalnızca çıkış. Gerçek kullanıcıların eki indirmesine izin vermek için kullanılması gereken indirme URL'si. Sohbet uygulamaları, ek içeriğini indirmek için bu URL'yi kullanmamalıdır.

Source

Yalnızca çıkış. Ekin kaynağı.

AttachmentDataRef

İsteğe bağlı. Ek verilerine referans. Bu alan, ek içeren mesajlar oluşturmak veya güncellemek ya da medya API'siyle ek verilerini indirmek için kullanılır.

DriveDataRef

Yalnızca çıkış. Google Drive eki referansı. Bu alan, Google Drive API ile kullanılır.

string

İsteğe bağlı. Ek verilerinin kaynak adı. Bu alan, ek verilerini indirmek için media API ile birlikte kullanılır.

string

İsteğe bağlı. Yüklenen bir eke referans içeren opak jeton. İstemciler tarafından opak bir dize olarak değerlendirilir ve ek içeren Chat mesajları oluşturmak veya güncellemek için kullanılır.

string

Mesaj birden fazla kart içeriyorsa gereklidir. Bir mesajdaki kartın benzersiz tanımlayıcısıdır.

Card

Kart. Maksimum boyut 32 KB'tır.

string

Bağlı Chat alanı kaynağının alanı.

Biçim: spaces/{space}

string

Bağlı Chat alanı kaynağının mesaj dizisi.

Biçim: spaces/{space}/threads/{thread}

string

Bağlı Chat alanı kaynağının mesajı.

Biçim: spaces/{space}/messages/{message}

string

Zorunlu. İçe aktarma modu alanının kaynak adı.

Biçim: spaces/{space}

Space

İçe aktarma modu alanı.

CardHeader

Kartın başlığı. Başlıklar genellikle bir başlık ve resim içerir.

Section

Bölümler bir satır ayırıcıyla ayrılır.

CardAction

Bu kartın işlemleri.

string

Kartın adı.

string

Etiket, işlem menüsü öğesinde gösteriliyordu.

OnClick

Bu işlem öğesinin tıklama işlemi.

string

Başlık belirtilmelidir. Başlığın yüksekliği sabittir: Hem başlık hem de altyazı belirtilirse her biri bir satır kaplar. Yalnızca başlık belirtilirse her iki satır da başlığı kaplar.

string

Kart başlığının alt başlığı.

ImageStyle

Resmin türü (ör. kare kenarlıklı veya dairesel kenarlıklı).

string

Kart başlığındaki resmin URL'si.

string

Bölümün başlığı. Biçimlendirilmiş metin desteklenir. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

WidgetMarkup

Bir bölüm en az bir widget içermelidir.

CustomEmoji

Zorunlu. Oluşturulacak özel emoji.

string

Zorunlu. Üyeliğin oluşturulacağı alanın kaynak adı.

Biçim: spaces/{space}

Membership

Zorunlu. Oluşturulacak üyelik ilişkisi.

memberType alanında, user.name ve user.type alanları doldurulmuş bir kullanıcı bulunmalıdır. Sunucu bir kaynak adı atar ve belirtilen her şeyin üzerine yazar.

Chat uygulaması, gerçek bir kullanıcı için üyelik ilişkisi oluştururken belirli yetkilendirme kapsamlarını kullanması ve belirli alanlar için belirli değerler ayarlamalıdır:

• Kullanıcı olarak kimlik doğrulama yapılırken chat.memberships yetkilendirme kapsamı gereklidir.

• Uygulama olarak kimlik doğrulama yapılırken chat.app.memberships yetkilendirme kapsamı gereklidir. Uygulama olarak kimlik doğrulama aşağıdaki platformlarda kullanılabilir:

• user.type değerini HUMAN olarak, user.name değerini ise users/{user} biçiminde ayarlayın. {user}, kullanıcının e-posta adresi olabilir. Aynı Workspace kuruluşundaki kullanıcılar için {user}, People API'deki kişinin id veya Directory API'deki kullanıcının id olabilir. Örneğin, user@example.com için People API kişi profili kimliği 123456789 ise membership.member.name değerini users/user@example.com veya users/123456789 olarak ayarlayarak kullanıcıyı alana ekleyebilirsiniz.

Bir Chat uygulaması kendisi için üyelik ilişkisi oluşturduğunda kullanıcı olarak kimlik doğrulaması yapmalı ve chat.memberships.app kapsamını kullanmalı, user.type değerini BOT olarak, user.name değerini ise users/app olarak ayarlamalıdır.

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.memberships OAuth 2.0 kapsamını gerektirir.

Yönetici erişimi kullanılarak uygulama üyelikleri veya yöneticinin Google Workspace kuruluşunun dışındaki kullanıcılar için üyelikler oluşturma desteklenmez.

string

Zorunlu. Mesajın oluşturulacağı alanın kaynak adı.

Biçim: spaces/{space}

Message

Zorunlu. İleti gövdesi.

string

İsteğe bağlı. Desteği sonlandırıldı: Bunun yerine thread.thread_key politikasını kullanın. İleti dizisinin kimliği. En fazla 4.000 karakter desteklenir. Bir ileti dizisi başlatmak veya mevcut bir ileti dizisine eklemek için bir ileti oluşturun ve threadKey veya thread.name belirtin. Örnek kullanım için Mesaj dizisi başlatma veya yanıtlama başlıklı makaleyi inceleyin.

string

İsteğe bağlı. Bu mesaj için benzersiz bir istek kimliği. Mevcut bir istek kimliği belirtmek, yeni bir mesaj oluşturmak yerine bu kimlikle oluşturulan mesajı döndürür.

MessageReplyOption

İsteğe bağlı. Bir mesajın mesaj dizisi başlatıp başlatmadığını veya bir mesaj dizisini yanıtlayıp yanıtlamadığını belirtir. Yalnızca adlandırılmış alanlarda desteklenir.

Kullanıcı etkileşimlerine yanıt verirken bu alan yoksayılır. İleti dizisindeki etkileşimler için yanıt, aynı mesaj dizisinde oluşturulur. Aksi takdirde yanıt yeni bir ileti dizisi olarak oluşturulur.

string

İsteğe bağlı. Bir ileti için özel kimlik. Chat uygulamalarının, sistem tarafından atanan kimliği mesajın kaynak adında (mesajın name alanında temsil edilir) depolamaya gerek kalmadan mesaj almasına, güncellemesine veya silmesine olanak tanır.

Bu alanın değeri aşağıdaki koşulları karşılamalıdır:

• client- ile başlar. Örneğin, client-custom-name geçerli bir özel kimliktir ancak custom-name geçerli değildir.
• En fazla 63 karakterden oluşmalı ve yalnızca küçük harf, rakam ve kısa çizgi içermelidir.
• Alan içinde benzersiz olmalıdır. Sohbet uygulamaları, farklı mesajlar için aynı özel kimliği kullanamaz.

Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

string

Zorunlu. Tepkinin oluşturulduğu mesaj.

Biçim: spaces/{space}/messages/{message}

Reaction

Zorunlu. Oluşturulacak tepki.

Space

Zorunlu. displayName ve spaceType alanları doldurulmalıdır. Yalnızca SpaceType.SPACE ve SpaceType.GROUP_CHAT desteklenir. SpaceType.GROUP_CHAT yalnızca importMode doğru olarak ayarlanmışsa kullanılabilir.

ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName kullanmayı deneyin. Google Workspace kuruluşunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.

name alanı sunucuda atandığından bu alanda belirtilen her şey yoksayılır.

string

İsteğe bağlı. Bu istek için benzersiz bir tanımlayıcı. Rastgele bir UUID kullanılması önerilir. Mevcut bir istek kimliği belirtmek, yeni bir alan oluşturmak yerine bu kimlikle oluşturulan alanı döndürür. Aynı Chat uygulamasında kimliği doğrulanmış farklı bir kullanıcının mevcut istek kimliğini belirtmek hata döndürür.

string

Tanımlayıcı. Sunucu tarafından atanan özel emojinin kaynak adı.

Biçim: customEmojis/{customEmoji}

string

Yalnızca çıkış. Özel emoji kaynağının benzersiz anahtarı.

string

İsteğe bağlı. Değişmez. Özel emoji için kullanıcı tarafından sağlanan ve kuruluş içinde benzersiz olan ad.

Özel emoji oluşturulurken gereklidir, aksi takdirde yalnızca çıkışta kullanılır.

Emoji adları iki nokta işaretiyle başlayıp bitmeli, küçük harfle yazılmalı ve yalnızca alfanümerik karakterler, kısa çizgi ve alt çizgi içermelidir. Kelimeleri ayırmak için kısa çizgi ve alt çizgi kullanılmalıdır ancak bunlar art arda kullanılamaz.

Örnek: :valid-emoji-name:

string

Yalnızca çıkış. Özel emojinin resim URL'si (en az 10 dakika boyunca geçerlidir). Özel emoji oluşturulduğunda bu alanın yanıtta doldurulmadığını unutmayın.

CustomEmojiPayload

İsteğe bağlı. Yalnızca giriş. Yük verileri. Özel emoji oluşturulurken gereklidir.

bytes

Zorunlu. Yalnızca giriş. Özel emoji için kullanılan resim.

Yük 256 KB'tan küçük, resmin boyutu ise 64 ila 500 piksel arasında olmalıdır. Kısıtlamalar değişebilir.

string

Zorunlu. Yalnızca giriş. Resim dosyasının adı.

Desteklenen dosya uzantıları: .png, .jpg, .gif.

string

Zorunlu. Silinecek özel emojinin kaynak adı.

Biçim: customEmojis/{customEmoji}

{customEmoji} için takma ad olarak emoji adını kullanabilirsiniz. Örneğin, customEmojis/:example-emoji: (:example-emoji:, özel emojinin adı olur).

string

Zorunlu. Silinecek üyeliğin kaynak adı. Sohbet uygulamaları, gerçek kullanıcıların veya kendi üyeliklerini silebilir. Chat uygulamaları, diğer uygulamaların üyeliklerini silemez.

Gerçek kullanıcı üyeliğini silerken chat.memberships kapsamı ve spaces/{space}/members/{member} biçimi gerekir. E-postayı {member} için takma ad olarak kullanabilirsiniz. Örneğin, spaces/{space}/members/example@gmail.com (example@gmail.com, Google Chat kullanıcısının e-posta adresidir).

Bir uygulama üyeliğini silerken chat.memberships.app kapsamı ve spaces/{space}/members/app biçimi gerekir.

Biçim: spaces/{space}/members/{member} veya spaces/{space}/members/app.

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.memberships OAuth 2.0 kapsamını gerektirir.

Yönetici erişimi kullanılarak bir alandaki uygulama üyeliklerinin silinmesi desteklenmez.

string

Zorunlu. Mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}

Mesajınız için özel bir kimlik belirlediyseniz {message} için clientAssignedMessageId alanındaki değeri kullanabilirsiniz. Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

bool

İsteğe bağlı. true ise bir mesajın silinmesi, mesajın mesaj dizili yanıtlarını da siler. false olduğunda, bir ileti dizisinde yanıt varsa silme işlemi başarısız olur.

Yalnızca kullanıcı olarak kimlik doğrulama işleminde geçerlidir. Chat uygulaması olarak kimlik doğrulaması yapılırken herhangi bir etkisi yoktur.

string

Zorunlu. Silinecek tepkinin adı.

Biçim: spaces/{space}/messages/{message}/reactions/{reaction}

string

Zorunlu. Silinecek alanın kaynak adı.

Biçim: spaces/{space}

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.delete OAuth 2.0 kapsamını gerektirir.

DeletionType

Mesajı kimin sildiğini belirtir.

Card

Yalnızca giriş. Modal olarak oluşturulan iletişim kutusunun gövdesi. Google Chat uygulamaları şu kart varlıklarını desteklemez: DateTimePicker, OnChangeAction.

ActionStatus

Yalnızca giriş. İletişim kutusu başlatma veya gönderme isteğinin durumu. Gerekirse kullanıcılara bir durum ve mesaj gösterir. Örneğin, hata veya başarı durumunda.

Dialog

Yalnızca giriş. İstek için iletişim kutusu.

string

Drive dosyasının kimliği. Drive API ile kullanın.

DriveDataRef

Bir Google Drive dosyasına referans veren DriveDataRef.

string

Bağlı Google Drive kaynağının MIME türü.

string

İsteğe bağlı. Unicode dizesi ile temsil edilen temel bir emoji.

CustomEmoji

Yalnızca çıkış. Özel emoji.

Emoji

Yalnızca çıkış. Tepkilerle ilişkili emojiler.

int32

Yalnızca çıkış. İlişkili emojinin kullanıldığı toplam tepki sayısı.

string

Zorunlu. Doğrudan mesajı bulunacak kullanıcının kaynak adı.

Biçim: users/{user}. Burada {user}, People API'deki kişi için id veya Directory API'deki kullanıcı için id değerini ifade eder. Örneğin, People API profil kimliği 123456789 ise name olarak users/123456789 değerini kullanarak bu kişiyle doğrudan mesajı bulabilirsiniz. Kullanıcı olarak kimlik doğrulaması yaptığınızda e-postayı {user} için takma ad olarak kullanabilirsiniz. Örneğin, users/example@gmail.com (example@gmail.com, Google Chat kullanıcısının e-posta adresidir).

string

Zorunlu. Ekin kaynak adı (spaces/{space}/messages/{message}/attachments/{attachment} biçiminde).

string

Zorunlu. Özel emojinin kaynak adı.

Biçim: customEmojis/{customEmoji}

{customEmoji} için takma ad olarak emoji adını kullanabilirsiniz. Örneğin, customEmojis/:example-emoji: (:example-emoji:, özel emojinin adı olur).

string

Zorunlu. Alınacak üyeliğin kaynak adı.

Kullanıcı kimlik doğrulamasını kullanarak uygulamanın kendi üyeliğini almak için isteğe bağlı olarak spaces/{space}/members/app kullanabilirsiniz.

Biçim: spaces/{space}/members/{member} veya spaces/{space}/members/app

Kullanıcının e-posta adresini {member} için takma ad olarak kullanabilirsiniz. Örneğin, spaces/{space}/members/example@gmail.com (example@gmail.com, Google Chat kullanıcısının e-posta adresidir).

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.memberships veya chat.admin.memberships.readonly OAuth 2.0 kapsamlarını gerektirir.

Yönetici erişimi kullanılırken bir alanda uygulama üyeliği alma işlemi desteklenmez.

string

Zorunlu. Mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}

Mesajınız için özel bir kimlik belirlediyseniz {message} için clientAssignedMessageId alanındaki değeri kullanabilirsiniz. Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

string

Zorunlu. Alan etkinliğinin kaynak adı.

Biçim: spaces/{space}/spaceEvents/{spaceEvent}

string

Zorunlu. Biçim: users/{user}/spaces/{space}/spaceNotificationSetting

• users/me/spaces/{space}/spaceNotificationSetting VEYA
• users/user@example.com/spaces/{space}/spaceNotificationSetting VEYA
• users/123456789/spaces/{space}/spaceNotificationSetting. Not: Yolda yalnızca arayanın kullanıcı kimliğine veya e-posta adresine izin verilir.

string

Zorunlu. Alınacak alanın okuma durumunun kaynak adı.

Yalnızca arayan kullanıcının okuma durumunu alma işlemini destekler.

Arayan kullanıcıyı belirtmek için aşağıdakilerden birini ayarlayın:

• me takma adı. Örneğin, users/me/spaces/{space}/spaceReadState.

• Workspace e-posta adresleri Örneğin, users/user@example.com/spaces/{space}/spaceReadState.

• Kullanıcı kimliği. Örneğin, users/123456789/spaces/{space}/spaceReadState.

Biçim: users/{user}/spaces/{space}/spaceReadState

string

Zorunlu. Alanın kaynak adı (spaces/{space} biçiminde).

Biçim: spaces/{space}

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces veya chat.admin.spaces.readonly OAuth 2.0 kapsamlarını gerektirir.

string

Zorunlu. Alınacak ileti dizisinin okunma durumunun kaynak adı.

Yalnızca arayan kullanıcının okuma durumunu alma işlemini destekler.

Arayan kullanıcıyı belirtmek için aşağıdakilerden birini ayarlayın:

• me takma adı. Örneğin, users/me/spaces/{space}/threads/{thread}/threadReadState.

• Workspace e-posta adresleri Örneğin, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.

• Kullanıcı kimliği. Örneğin, users/123456789/spaces/{space}/threads/{thread}/threadReadState.

Biçim: users/{user}/spaces/{space}/threads/{thread}/threadReadState

string

Bir Google grubu için kaynak adı.

Cloud Identity Groups API'de bir grubu temsil eder.

Format: groups/{group}

int32

İsteğe bağlı. Döndürülen maksimum özel emoji sayısı. Hizmet, bu değerden daha az özel emoji döndürebilir. Belirtilmediği takdirde varsayılan değer 25'tir. Maksimum değer 200'dür. 200'ün üzerindeki değerler 200 olarak değiştirilir.

string

İsteğe bağlı. (Önceki bir sorgudan devam ediliyorsa.)

Önceki bir liste özel emoji çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer göndermek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sorgu filtresi.

İçerik üreticiye göre filtrelemeyi destekler.

İçerik üreticiye göre filtrelemek için geçerli bir değer belirtmeniz gerekir. Özel emojileri, arayan kullanıcı tarafından oluşturulup oluşturulmadıklarına göre filtrelemek için şu anda yalnızca creator("users/me") ve NOT creator("users/me") kabul edilmektedir.

Örneğin, aşağıdaki sorgu arayan tarafından oluşturulan özel emojiyi döndürür:

creator("users/me")

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

CustomEmoji

Sırasız liste. İstenen (veya ilk) sayfada bulunan özel emojilerin listesi.

string

Sonuçların bir sonraki sayfasını almak için pageToken olarak gönderebileceğiniz bir jeton. Boşsa sonraki sayfa yoktur.

string

Zorunlu. Üyelik listesinin alınacağı alanın kaynak adı.

Biçim: spaces/{space}

int32

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

Belirtilmemesi durumunda en fazla 100 üyelik döndürülür.

Maksimum değer 1.000'dir. 1.000'den yüksek bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir.

Negatif değerler INVALID_ARGUMENT hatası döndürür.

string

İsteğe bağlı. Üyelikleri listelemek için önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalandırma 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 göndermek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sorgu filtresi.

Üyelikleri üyenin rolüne (role) ve türüne (member.type) göre filtreleyebilirsiniz.

Role göre filtrelemek için role öğesini ROLE_MEMBER veya ROLE_MANAGER olarak ayarlayın.

Türü filtrelemek için member.type öğesini HUMAN veya BOT olarak ayarlayın. != operatörünü kullanarak member.type için de filtreleme yapabilirsiniz.

Hem role hem de türe göre filtrelemek için AND operatörünü kullanın. Rol veya türe göre filtrelemek için OR operatörünü kullanın.

use_admin_access doğru olarak ayarlandığında member.type = "HUMAN" veya member.type != "BOT" gereklidir. Diğer üye türü filtreleri reddedilir.

Örneğin, aşağıdaki sorgular geçerlidir:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Aşağıdaki sorgular geçersiz:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

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

bool

İsteğe bağlı. true olduğunda, diğer üyelik türlerinin yanı sıra Google Group ile ilişkili üyelikleri de döndürür. Bir filter ayarlanırsa filtre ölçütleriyle eşleşmeyen Google Group üyelikleri döndürülmez.

bool

İsteğe bağlı. true olduğunda, diğer üyelik türlerinin yanı sıra invited üyeleriyle ilişkili üyelikleri de döndürür. Filtre ayarlanırsa filtre ölçütleriyle eşleşmeyen invited üyelikleri döndürülmez.

Şu anda kullanıcı kimlik doğrulaması gerektirmektedir.

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.memberships.readonly veya chat.admin.memberships OAuth 2.0 kapsamını gerektirir.

Yönetici erişimi kullanılırken bir alanda uygulama üyeliklerini listeleme özelliği desteklenmez.

Membership

Sırasız liste. İstenen (veya ilk) sayfadaki üyeliklerin listesi.

string

Sonuçların bir sonraki sayfasını almak için pageToken olarak gönderebileceğiniz bir jeton. Boşsa sonraki sayfa yoktur.

string

Zorunlu. Mesajların listeleneceği alanın kaynak adı.

Biçim: spaces/{space}

int32

İsteğe bağlı. Döndürülen maksimum mesaj sayısı. Hizmet bu değerden daha az ileti döndürebilir.

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

Maksimum değer 1.000'dir. 1.000'den yüksek bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir.

Negatif değerler INVALID_ARGUMENT hatası döndürür.

string

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

Sayfalandırma 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 göndermek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sorgu filtresi.

İletileri tarihe (create_time) ve ileti dizisine (thread.name) göre filtreleyebilirsiniz.

İletileri oluşturuldukları tarihe göre filtrelemek için create_time öğesini RFC-3339 biçiminde bir zaman damgasıyla ve çift tırnak içinde belirtin. Örneğin, "2023-04-21T11:30:00-04:00". Bir zaman damgasından sonra oluşturulan iletileri listelemek için büyüktür operatörünü >, bir zaman damgasından önce oluşturulan iletileri listelemek için de küçüktür operatörünü < kullanabilirsiniz. Belirli bir zaman aralığındaki iletileri filtrelemek için iki zaman damgası arasına AND operatörünü ekleyin.

İleti dizisine göre filtrelemek için thread.name değerini spaces/{space}/threads/{thread} olarak biçimlendirerek belirtin. Sorgu başına yalnızca bir thread.name belirtebilirsiniz.

Hem ileti dizisine hem de tarihe göre filtrelemek için sorgunuzda AND operatörünü kullanın.

Örneğin, aşağıdaki sorgular geçerlidir:

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

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

string

İsteğe bağlı. Mesaj listesinin sıralaması. Sıralama işlemine göre sıralanmak üzere bir değer belirtin. Geçerli sıralama işlemi değerleri şunlardır:

• Artan için ASC.

• Azalan düzen için DESC.

Varsayılan sıralama create_time ASC'tür.

bool

İsteğe bağlı. Silinen iletilerin dahil edilip edilmeyeceği. Silinen iletilerde, iletilerin silinme zamanı ve silinmeyle ilgili meta veriler yer alır ancak ileti içeriği kullanılamaz.

Message

Mesaj listesi.

string

Sonuçların bir sonraki sayfasını almak için pageToken olarak bir jeton gönderebilirsiniz. Boşsa sonraki sayfa yoktur.

string

Zorunlu. Kullanıcıların tepki verdiği mesaj.

Biçim: spaces/{space}/messages/{message}

int32

İsteğe bağlı. Döndürülen maksimum tepki sayısı. Hizmet bu değerden daha az tepki döndürebilir. Belirtilmediği takdirde varsayılan değer 25'tir. Maksimum değer 200'dür. 200'ün üzerindeki değerler 200 olarak değiştirilir.

string

İsteğe bağlı. (Önceki bir sorgudan devam ediliyorsa.)

Önceki bir liste tepkileri çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer göndermek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sorgu filtresi.

Tepkileri emojiye (emoji.unicode veya emoji.custom_emoji.uid) ve kullanıcıya (user.name) göre filtreleyebilirsiniz.

Birden fazla emoji veya kullanıcıya ait tepkileri filtrelemek için benzer alanları OR operatörüyle (ör. emoji.unicode = "🙂" OR emoji.unicode = "👍" ve user.name = "users/AAAAAA" OR user.name = "users/BBBBBB") birleştirin.

Tepkileri emojiye ve kullanıcıya göre filtrelemek için AND operatörünü (ör. emoji.unicode = "🙂" AND user.name = "users/AAAAAA") kullanın.

Sorgunuzda hem AND hem de OR kullanılıyorsa bunları parantezle gruplandırın.

Örneğin, aşağıdaki sorgular geçerlidir:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Aşağıdaki sorgular geçersiz:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

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

Reaction

İstenen (veya ilk) sayfadaki tepkilerin listesi.

string

Sonuçların bir sonraki sayfasını almak için devam jetonu. Sonuçların son sayfası için boştur.

string

Zorunlu. Etkinliklerin gerçekleştiği Google Chat alanının kaynak adı.

Biçim: spaces/{space}.

int32

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

Negatif değerler INVALID_ARGUMENT hatası döndürür.

string

İsteğe bağlı. Önceki bir liste alanı etkinlikleri çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalandırma yaparken, alan etkinliklerini listelemek için sağlanan diğer tüm parametreler sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Diğer parametrelere farklı değerler göndermek beklenmedik sonuçlara yol açabilir.

string

Zorunlu. Sorgu filtresi.

": operatörünü kullanarak en az bir etkinlik türü (event_type) belirtmeniz gerekir. Birden fazla etkinlik türüne göre filtrelemek için OR operatörünü kullanın. Filtrenizde toplu etkinlik türlerini çıkarın. İstek, ilgili tüm toplu etkinlikleri otomatik olarak döndürür. Örneğin, yeni tepkilere (google.workspace.chat.reaction.v1.created) göre filtreleme yaparsanız sunucu, yeni tepkiler toplu etkinliğini (google.workspace.chat.reaction.v1.batchCreated) de döndürür. Desteklenen etkinlik türlerinin listesi için SpaceEvents referans dokümanlarına bakın.

İsteğe bağlı olarak başlangıç zamanına (start_time) ve bitiş zamanına (end_time) göre de filtreleme yapabilirsiniz:

• start_time: Alan etkinliklerini listelemenin başlayacağı özel zaman damgası. 28 güne kadar önce gerçekleşen etkinlikleri listeleyebilirsiniz. Belirtilmemişse son 28 güne ait alan etkinliklerini listeler.
• end_time: Alan etkinliklerinin listelendiği zaman damgası. Belirtilmemişse istek tarihine kadar olan etkinlikler listelenir.

Başlangıç veya bitiş saatini belirtmek için eşittir = operatörünü kullanın ve RFC-3339 biçimini uygulayın. Hem start_time hem de end_time'ye göre filtrelemek için AND operatörünü kullanın.

Örneğin, aşağıdaki sorgular geçerlidir:

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"

start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

Aşağıdaki sorgular geçersiz:

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"

event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

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

SpaceEvent

Sonuçlar kronolojik sırayla (en eski etkinlik önce) döndürülür. Not: permissionSettings alanı, liste istekleri için Alan nesnesinde döndürülmez.

string

Daha fazla etkinlik almak için kullanılan devam ağı jetonu. Bu alan atlanırsa sonraki sayfalar olmaz.

int32

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

Belirtilmemesi durumunda en fazla 100 alan döndürülür.

Maksimum değer 1.000'dir. 1.000'den yüksek bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir.

Negatif değerler INVALID_ARGUMENT hatası döndürür.

string

İsteğe bağlı. Önceki bir listSpaces çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalandırma yaparken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer göndermek beklenmedik sonuçlara yol açabilir.

string

İsteğe bağlı. Sorgu filtresi.

Alanları alan türüne göre filtreleyebilirsiniz (space_type).

Alan türüne göre filtrelemek için SPACE veya GROUP_CHAT gibi geçerli bir enum değeri belirtmeniz gerekir (space_type SPACE_TYPE_UNSPECIFIED olamaz). Birden fazla alan türü için sorgu yapmak istiyorsanız OR operatörünü kullanın.

Örneğin, aşağıdaki sorgular geçerlidir:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

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

Space

İstenen (veya ilk) sayfadaki alanların listesi. Not: permissionSettings alanı, liste istekleri için Alan nesnesinde döndürülmez.

string

Sonuçların bir sonraki sayfasını almak için pageToken olarak bir jeton gönderebilirsiniz. Boşsa sonraki sayfa yoktur.

string

Yalnızca çıkış. Eşleşen URL.

string

Tanımlayıcı. Sunucu tarafından atanan üyeliğin kaynak adı.

Biçim: spaces/{space}/members/{member}

MembershipState

Yalnızca çıkış. Üyeliğin durumu.

MembershipRole

İsteğe bağlı. Kullanıcının Chat alanındaki rolü. Bu rol, alanda izin verilen işlemlerini belirler.

Bu alan yalnızca UpdateMembership alanında giriş olarak kullanılabilir.

Timestamp

İsteğe bağlı. Değişmez. Üyeliğin oluşturulduğu zaman (ör. üyenin alana katıldığı veya alana katılmaya davet edildiği zaman). Bu alan, yalnızca geçmiş üyelikleri içe aktarma modu alanlarından içe aktarmak için kullanıldığında çıkışa yöneliktir.

Timestamp

İsteğe bağlı. Değişmez. Üyeliğin silinme zamanı (ör. üyenin alandan ayrıldığı veya alandan çıkarıldığı zaman). Bu alan, yalnızca geçmiş üyelikleri içe aktarma modu alanlarından içe aktarmak için kullanıldığında çıkışa yöneliktir.

User

İsteğe bağlı. Üyeliğin karşılık geldiği Google Chat kullanıcısı veya uygulaması. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkışta kullanıcı name ve type alanları doldurulur.

Group

İsteğe bağlı. Üyeliğin karşılık geldiği Google grubu.

Google Gruplar'daki üyelikleri okumak veya değiştirmek için kullanıcı kimlik doğrulaması gerekir.

MembershipCreatedEventData

Yeni üyeliklerin listesi.

MembershipDeletedEventData

Silinen üyeliklerin listesi.

MembershipUpdatedEventData

Güncellenen üyeliklerin listesi.

Membership

Yeni üyelik.

Membership

Silinen üyelik. Yalnızca name ve state alanları doldurulur.

Membership

Güncellenen üyelik.

string

Tanımlayıcı. Mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}

Burada {space}, mesajın yayınlandığı alanın kimliği, {message} ise mesaja sistem tarafından atanan kimliktir. Örneğin, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Mesaj oluştururken özel bir kimlik ayarlarsanız {message} değerini clientAssignedMessageId alanındaki değerle değiştirerek mesajı bir istekte belirtmek için bu kimliği kullanabilirsiniz. Örneğin, spaces/AAAAAAAAAAA/messages/client-custom-name. Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

User

Yalnızca çıkış. İletiyi oluşturan kullanıcı. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkışta kullanıcı name ve type alanları doldurulur.

Timestamp

İsteğe bağlı. Değişmez. Chat'te oluşturulan alanlar için mesajın oluşturulduğu saat. Bu alan, içe aktarma modu alanlarında kullanıldığında hariç olmak üzere yalnızca çıkış içindir.

İçe aktarma modu alanları için bu alanı, orijinal oluşturulma zamanını korumak amacıyla ileti kaynağında oluşturulduğu tarihsel zaman damgasına ayarlayın.

Timestamp

Yalnızca çıkış. Mesajın bir kullanıcı tarafından en son düzenlendiği zaman. Mesaj hiç düzenlenmediyse bu alan boştur.

Timestamp

Yalnızca çıkış. İletinin Google Chat'te silindiği zaman. Mesaj hiç silinmezse bu alan boş olur.

string

İsteğe bağlı. İletinin düz metin gövdesi. Bir resme, videoya veya web sayfasına ait ilk bağlantı, önizleme çipi oluşturur. Ayrıca bir Google Chat kullanıcısını@bahsetme veya alandaki herkesi etiketleyebilirsiniz.

Kısa mesaj oluşturma hakkında bilgi edinmek için Mesaj gönderme başlıklı makaleyi inceleyin.

string

Yalnızca çıkış. Biçimlendirmeyi belirtmek için eklenen işaretlemelerle text mesajını içerir. Bu alan, kullanıcı arayüzünde görünen tüm biçimlendirmeleri yakalamayabilir ancak aşağıdakileri içerir:

• Kalın, italik, üstü çizili, monospace, monospace blok ve madde işaretli liste için işaretleme söz dizimi.

• <users/{user}> biçimini kullanan kullanıcı bahsetmeleri.

• İlk dizenin URL, ikincinin ise oluşturulan metin olduğu <{url}|{rendered_text}> biçimini kullanan özel köprüler (ör. <http://example.com|custom text>).

• :{emoji_name}: biçimini kullanan özel emoji (ör. :smile:). Bu durum, Unicode emojileri (ör. gülümseyen yüz emojisi için U+1F600) için geçerli değildir.

Daha fazla bilgi için İletiyle gönderilen metin biçimlendirmesini görüntüleme başlıklı makaleyi inceleyin.

Card

Desteği sonlandırıldı: Bunun yerine cards_v2 politikasını kullanın.

Biçimlendirilmiş metinler, düğmeler ve tıklanabilir resimler gibi kullanıcı arayüzü öğelerini görüntülemek için kullanabileceğiniz zengin, biçimlendirilmiş ve etkileşimli kartlar. Kartlar normalde ileti düz metin gövdesinin altında gösterilir. cards ve cards_v2 öğelerinin boyutu en fazla 32 KB olabilir.

CardWithId

İsteğe bağlı. Kart dizisi.

Yalnızca Chat uygulamaları kart oluşturabilir. Sohbet uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa mesajlar kart içeremez.

Kart içeren bir mesaj oluşturmayı öğrenmek için Mesaj gönderme başlıklı makaleyi inceleyin.

Kart Oluşturucu ile kart tasarlayın ve önizleyin.

Annotation

Yalnızca çıkış. Bu iletideki text ile ilişkili ek açıklamalar.

Thread

İletinin ait olduğu ileti dizisi. Örnek kullanım için Mesaj dizisi başlatma veya yanıtlama başlıklı makaleyi inceleyin.

Space

Yalnızca çıkış. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yaparsa çıkış yalnızca alanı name doldurur.

string

İsteğe bağlı. Gerçek kartlar görüntülenemediğinde (ör. mobil bildirimler) kullanılan, mesajın kartlarının düz metin açıklaması.

ActionResponse

Yalnızca giriş. Bir Chat uygulamasının yanıtının nasıl yayınlanacağını yapılandırmak için kullanabileceği parametreler.

string

Yalnızca çıkış. Tüm Chat uygulamasından bahsetmelerin kaldırıldığı, mesajın düz metin gövdesi.

SlashCommand

Yalnızca çıkış. Varsa eğik çizgi komutu bilgileri.

Attachment

İsteğe bağlı. Kullanıcı tarafından yüklenen ek.

MatchedUrl

Yalnızca çıkış. spaces.messages.text içinde, bağlantı önizleme kalıbıyla eşleşen bir URL. Daha fazla bilgi için Bağlantıları önizleme başlıklı makaleyi inceleyin.

bool

Yalnızca çıkış. true olduğunda mesaj, bir yanıt mesaj dizisindeki yanıttır. false olduğunda mesaj, alanın üst düzey görüşmesinde bir mesaj dizisinin ilk mesajı veya mesaj dizisi yanıtı olmayan bir mesaj olarak görünür.

Alanda mesaj dizilerinde yanıt verme özelliği desteklenmiyorsa bu alan her zaman false olur.

string

İsteğe bağlı. İleti için özel bir kimlik. Bir iletiyi tanımlamak veya almak, silmek ya da güncellemek için bu alanı kullanabilirsiniz. Özel kimlik ayarlamak için mesajı oluştururken messageId alanını belirtin. Ayrıntılar için Mesajlara ad verme başlıklı makaleyi inceleyin.

EmojiReactionSummary

Yalnızca çıkış. Mesajdaki emoji tepki özetlerinin listesi.

User

İsteğe bağlı. Değişmez. Mesaj oluşturmak için giriş, aksi takdirde yalnızca çıkış. Mesajın görüntüleyebileceği kullanıcı. Ayarlandığında mesaj gizlidir ve yalnızca belirtilen kullanıcı ve Chat uygulaması tarafından görülebilir. Bu alanı isteğinize dahil etmek için uygulama kimlik doğrulamasını kullanarak Chat API'yi çağırmanız ve aşağıdakileri atlamanız gerekir:

• Ekler
• Aksesuar widget'ları

Ayrıntılı bilgi için Mesajları gizli olarak gönderme başlıklı makaleyi inceleyin.

DeletionMetadata

Yalnızca çıkış. Silinen bir mesajla ilgili bilgiler. delete_time ayarlandığında mesaj silinir.

QuotedMessageMetadata

Yalnızca çıkış. Bir Google Chat kullanıcısı tarafından alanda alıntılanan mesajla ilgili bilgiler. Google Chat kullanıcıları, bir mesajı yanıtlamak için mesajı alıntılayabilir.

AttachedGif

Yalnızca çıkış. İletiye eklenen GIF resimler.

AccessoryWidget

İsteğe bağlı. Bir ileti dizisinin en altında görünen bir veya daha fazla etkileşimli widget. Metin, kart veya hem metin hem de kart içeren mesajlara aksesuar widget'ları ekleyebilirsiniz. İletişim kutuları içeren iletiler için desteklenmez. Ayrıntılar için Mesajın alt kısmına etkileşimli widget ekleme başlıklı makaleyi inceleyin.

Aksesuar widget'ları içeren bir mesaj oluşturmak için uygulama kimlik doğrulaması gerekir.

MessageCreatedEventData

Yeni mesajların listesi.

MessageDeletedEventData

Silinen mesajların listesi.

MessageUpdatedEventData

Güncellenen mesajların listesi.

Message

Yeni mesaj.

Message

Silinen mesaj. Yalnızca name, createTime, deleteTime ve deletionMetadata alanları doldurulur.

Message

Güncellenen mesaj.

string

Yalnızca çıkış. Alıntılanan mesajın kaynak adı.

Biçim: spaces/{space}/messages/{message}

Timestamp

Yalnızca çıkış. Alıntılanan mesajın oluşturulduğu veya en son güncellendiği zaman damgası.

string

Tanımlayıcı. Tepkinin kaynak adı.

Biçim: spaces/{space}/messages/{message}/reactions/{reaction}

User

Yalnızca çıkış. Tepkiyi oluşturan kullanıcı.

Emoji

Zorunlu. Tepkide kullanılan emoji.

ReactionCreatedEventData

Yeni tepkilerin listesi.

ReactionDeletedEventData

Silinen tepkilerin listesi.

Reaction

Yeni tepki.

Reaction

Silinen tepki.

string

Bu bağlantının URI'si.

RichLinkType

Zengin bağlantı türü.

DriveLinkData

Drive bağlantısı verileri.

ChatSpaceLinkData

Chat alanı bağlantısı verileri.

bool

true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces.readonly veya chat.admin.spaces OAuth 2.0 kapsamını gerektirir.

Bu yöntem şu anda yalnızca yönetici erişimini desteklediğinden bu alan için yalnızca true kabul edilir.

int32

Döndürülecek maksimum boşluk sayısı. Hizmet bu değerden daha az sonuç döndürebilir.

Belirtilmemesi durumunda en fazla 100 alan döndürülür.

Maksimum değer 1.000'dir. 1.000'den yüksek bir değer kullanırsanız bu değer otomatik olarak 1.000 olarak değiştirilir.

string

Önceki arama alanları çağrısından alınan bir jeton. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalandırma 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 göndermek beklenmedik sonuçlara yol açabilir.

string

Zorunlu. Arama sorgusu.

Aşağıdaki parametreleri kullanarak arama yapabilirsiniz:

• create_time
• customer
• display_name
• external_user_allowed
• last_active_time
• space_history_state
• space_type

create_time ve last_active_time, RFC-3339 biçiminde bir zaman damgası kabul eder. Desteklenen karşılaştırma operatörleri şunlardır: =, <, >, <=, >=.

customer zorunludur ve alanların hangi müşteriden alınacağını belirtmek için kullanılır. Yalnızca customers/my_customer değeri desteklenir.

display_name yalnızca HAS (:) operatörünü kabul eder. Eşlenecek metin önce jetonlara ayrılır ve her jeton, alanın display_name kısmındaki herhangi bir alt dize olarak büyük/küçük harf duyarlılığı olmadan ve bağımsız olarak önek eşlemesi yapılır. Örneğin, Fun Eve, Fun event veya The evening was fun ile eşleşir ancak notFun event veya even ile eşleşmez.

external_user_allowed, true veya false değerini kabul eder.

space_history_state yalnızca space kaynağının historyState alanındaki değerleri kabul eder.

space_type gereklidir ve yalnızca SPACE değeri geçerlidir.

Farklı alanlarda yalnızca AND operatörleri desteklenir. Geçerli bir örnek space_type = "SPACE" AND display_name:"Hello", geçersiz bir örnek ise space_type = "SPACE" OR display_name:"Hello" şeklindedir.

Aynı alanda space_type, AND veya OR operatörlerini desteklemez. display_name, "space_history_state" ve "external_user_allowed" yalnızca OR operatörlerini destekler. last_active_time ve create_time, hem AND hem de OR operatörlerini destekler. AND yalnızca last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00" gibi bir aralığı temsil etmek için kullanılabilir.

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

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")

string

İsteğe bağlı. Alan listesinin sıralaması.

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

• membership_count.joined_direct_human_user_count: Doğrudan bir alana katılan gerçek kullanıcıların sayısını belirtir.
• last_active_time: Bu alanın herhangi bir konusuna son uygun öğenin eklendiği zamanı gösterir.
• create_time: Alanın oluşturulduğu zamanı gösterir.

Geçerli sıralama işlemi değerleri şunlardır:

• Artan için ASC. Varsayılan değer.

• Azalan düzen için DESC.

Desteklenen söz dizimleri şunlardır:

• membership_count.joined_direct_human_user_count DESC
• membership_count.joined_direct_human_user_count ASC
• last_active_time DESC
• last_active_time ASC
• create_time DESC
• create_time ASC

Space

İstenen alanların bulunduğu sayfa.

string

Sonraki sayfayı almak için kullanılabilecek bir jeton. Bu alan boşsa sonraki sayfa yoktur.

int32

Tüm sayfalarda sorguyla eşleşen boşlukların toplam sayısı. Sonuç 10.000'den fazla boşluk içeriyorsa bu değer bir tahmindir.

Space

Zorunlu. Space.spaceType alanı zorunludur.

Alan oluşturmak için Space.spaceType'ü SPACE olarak ayarlayın ve Space.displayName'yi ayarlayın. Alan oluştururken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName kullanmayı deneyin. Google Workspace kuruluşunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.

Grup sohbeti oluşturmak için Space.spaceType'ü GROUP_CHAT olarak ayarlayın. Space.displayName ayarını yapmayın.

Kullanıcılar arasında 1:1 görüşme oluşturmak için Space.spaceType değerini DIRECT_MESSAGE, Space.singleUserBotDm değerini ise false olarak ayarlayın. Space.displayName veya Space.spaceDetails ayarlanamaz.

Bir kullanıcı ile Chat uygulaması arasında 1:1 görüşme oluşturmak için Space.spaceType'ü DIRECT_MESSAGE, Space.singleUserBotDm'yi ise true olarak ayarlayın. Space.displayName veya Space.spaceDetails ayarlanamaz.

Halihazırda bir DIRECT_MESSAGE alanı varsa yeni bir alan oluşturmak yerine bu alan döndürülür.

string

İsteğe bağlı. Bu istek için benzersiz bir tanımlayıcı. Rastgele bir UUID kullanılması önerilir. Mevcut bir istek kimliği belirtmek, yeni bir alan oluşturmak yerine bu kimlikle oluşturulan alanı döndürür. Aynı Chat uygulamasında kimliği doğrulanmış farklı bir kullanıcının mevcut istek kimliğini belirtmek hata döndürür.

Membership

İsteğe bağlı. Alana katılmaya davet edilecek Google Chat kullanıcıları veya grupları. Arayan kullanıcı otomatik olarak ekleneceğinden bu kullanıcıyı atlayın.

Grup şu anda arayana ek olarak 20 üyeliğe kadar izin veriyor.

Kullanıcı üyeliği için Membership.member alanında, name doldurulmuş (biçim: users/{user}) ve type User.Type.HUMAN olarak ayarlanmış bir user bulunmalıdır. Yalnızca alan oluştururken gerçek kullanıcılar ekleyebilirsiniz (Chat uygulamalarının eklenmesi yalnızca arama uygulamasıyla doğrudan mesaj oluşturma için desteklenir). {user} için takma ad olarak kullanıcının e-posta adresini kullanarak da üye ekleyebilirsiniz. Örneğin, user.name users/example@gmail.com olabilir. Gmail kullanıcılarını veya harici Google Workspace alanlarındaki kullanıcıları davet etmek için {user} parametresinde kullanıcının e-postası kullanılmalıdır.

Google grubu üyeliği için Membership.group_member alanında, name değerinin doldurulduğu bir group bulunmalıdır (groups/{group} biçimi). Yalnızca Space.spaceType'i SPACE olarak ayarlarken Google grupları ekleyebilirsiniz.

Space.spaceType öğesi SPACE olarak ayarlandığında isteğe bağlıdır.

Space.spaceType değerini GROUP_CHAT olarak ayarlama işleminde en az iki üyelikle birlikte gereklidir.

Tam olarak bir üyelikle birlikte gerçek bir kullanıcıyla Space.spaceType'ü DIRECT_MESSAGE olarak ayarlama sırasında gereklidir.

Bir kullanıcı ile arayan Chat uygulaması arasında 1:1 görüşme oluştururken boş olmalıdır (Space.spaceType DIRECT_MESSAGE, Space.singleUserBotDm ise true olarak ayarlandığında).

int64

Çağrılan eğik çizgi komutunun kimliği.

User

Komutunun çağrıldığı Chat uygulaması.

Type

Eğik çizgi komutunun türü.

string

Çağrılan eğik çizgi komutunun adı.

int64

Çağrılan eğik çizgi komutunun komut kimliği.

bool

Eğik çizgi komutunun bir iletişim kutusu için olup olmadığını belirtir.

string

Tanımlayıcı. Alanın kaynak adı.

Biçim: spaces/{space}

Burada {space}, alana sistem tarafından atanan kimliği temsil eder. Alan kimliğini spaces.list() yöntemini çağırarak veya alan URL'sinden alabilirsiniz. Örneğin, alan URL'si https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA ise alan kimliği AAAAAAAAA olur.

Type

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine space_type politikasını kullanın. Alanın türü.

SpaceType

İsteğe bağlı. Alanın türü. Alan oluştururken veya bir alanın alan türünü güncellerken gereklidir. Yalnızca diğer kullanımlar için çıkış.

bool

İsteğe bağlı. Alanın, bir Chat uygulaması ile tek bir kullanıcı arasında doğrudan mesaj (DM) olup olmadığı.

bool

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine spaceThreadingState politikasını kullanın. Bu alanda mesajların dizili olup olmadığı.

string

İsteğe bağlı. Alanın görünen adı. SPACE spaceType değerine sahip bir alan oluştururken gereklidir. Alan oluştururken veya displayName'yi güncellerken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName kullanmayı deneyin. Google Workspace kuruluşunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.

Doğrudan mesajlarda bu alan boş olabilir.

En fazla 128 karakter desteklenir.

bool

İsteğe bağlı. Değişmez. Bu alanın, Google Chat kullanıcılarının üye olmasına izin verip vermediği. Google Workspace kuruluşunda alan oluştururken girilen giriş. Aşağıdaki durumlarda alan oluştururken bu alanı atlayın:

• Kimliği doğrulanmış kullanıcı bir tüketici hesabı (yönetilmeyen kullanıcı hesabı) kullanıyor. Tüketici hesabı tarafından oluşturulan alanlar varsayılan olarak tüm Google Chat kullanıcılarına izin verir.

Mevcut alanlar için bu alan yalnızca çıkıştır.

SpaceThreadingState

Yalnızca çıkış. Chat alanındaki mesaj dizili mesaj durumu.

SpaceDetails

İsteğe bağlı. Açıklama ve kurallar dahil olmak üzere alanla ilgili ayrıntılar.

HistoryState

İsteğe bağlı. Bu alandaki mesajlar ve ileti dizileri için mesaj geçmişi durumu.

bool

İsteğe bağlı. Bu alanın, Google Workspace'e veri taşıma işlemi kapsamında Import Mode'te oluşturulup oluşturulmadığı. Alanlar içe aktarılırken içe aktarma işlemi tamamlanana kadar kullanıcılar tarafından görülemez.

Import Mode'te alan oluşturmak için kullanıcı kimlik doğrulaması gerekir.

Timestamp

İsteğe bağlı. Değişmez. Chat'te oluşturulan alanlar için alanın oluşturulduğu saat. Bu alan, içe aktarma modu alanlarında kullanıldığında hariç olmak üzere yalnızca çıkış içindir.

İçe aktarma modundaki alanlar için bu alanı, orijinal oluşturma zamanını korumak amacıyla alanın kaynakta oluşturulduğu tarih damgasına ayarlayın.

Yalnızca spaceType GROUP_CHAT veya SPACE olduğunda çıkışta doldurulur.

Timestamp

Yalnızca çıkış. Alandaki son mesajın zaman damgası.

bool

Yalnızca çıkış. Chat uygulaması içeren doğrudan mesaj (DM) alanları için alanın bir Google Workspace yöneticisi tarafından oluşturulup oluşturulmadığı. Yöneticiler, kuruluşlarındaki kullanıcılar adına Chat uygulamasını yükleyip doğrudan mesaj ayarlayabilir.

Yönetici yüklemesini desteklemek için Chat uygulamanızda doğrudan mesajlaşma özelliği olmalıdır.

MembershipCount

Yalnızca çıkış. Üye türüne göre gruplandırılmış, katılan üyeliklerin sayısı. space_type SPACE, DIRECT_MESSAGE veya GROUP_CHAT olduğunda doldurulur.

AccessSettings

İsteğe bağlı. Alanın erişim ayarını belirtir. Yalnızca space_type SPACE olduğunda doldurulur.

string

Yalnızca çıkış. Kullanıcının alana erişmesi için URI.

string

İsteğe bağlı. Değişmez. Alanın müşteri kimliği. Yalnızca uygulama kimlik doğrulamasıyla alan oluştururken ve SpaceType SPACE ise gereklidir. Aksi takdirde ayarlanmamalıdır.

customers/{customer} biçimindedir. Burada customer, [Admin SDK müşteri kaynağındaki]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers) id değeridir. Gizli uygulamalar, alanı uygulamayla aynı Google Workspace kuruluşunda oluşturmak için customers/my_customer takma adını da kullanabilir.

DM'ler için bu alan doldurulmaz.

PredefinedPermissionSettings

İsteğe bağlı. Yalnızca giriş. Önceden tanımlanmış alan izni ayarları, yalnızca alan oluştururken girilir. Alan ayarlanmamışsa bir ortak çalışma alanı oluşturulur. Alanı oluşturduktan sonra ayarlar PermissionSettings alanına doldurulur.

PermissionSettings

İsteğe bağlı. Mevcut alanlar için alan izni ayarları. Mevcut izin ayarlarının değiştirildiği tam alan izin ayarlarını güncellemek için giriş. Çıkışta mevcut izin ayarları listelenir.

AccessState

Yalnızca çıkış. Alanın erişim durumunu gösterir.

string

İsteğe bağlı. Alanı keşfedebilen, alana katılabilen ve alandaki mesajları önizleyebilen hedef kitlenin kaynak adı. Bu ayar devre dışıysa alana yalnızca tek tek davet edilen veya alana eklenen kullanıcılar ya da Google Gruplar erişebilir. Ayrıntılı bilgi için Bir alanı hedef kitle için keşfedilebilir hale getirme başlıklı makaleyi inceleyin.

Biçim: audiences/{audience}

Google Workspace kuruluşu için varsayılan hedef kitleyi kullanmak istiyorsanız audiences/default olarak ayarlayın.

Hedef kitleyi okuma özelliği şunları destekler:

• Kullanıcı kimlik doğrulaması

• chat.app.spaces kapsamında yönetici onayı ile uygulama kimlik doğrulaması

chat.bot kapsamı uygulama kimlik doğrulamasıyla kullanıldığında bu alan doldurulmaz.

Hedef kitleyi ayarlamak için kullanıcı kimlik doğrulaması gerekir.

int32

Yalnızca çıkış. Bir gruba üye olarak katılan kullanıcılar hariç, alana doğrudan katılan gerçek kullanıcıların sayısı.

int32

Yalnızca çıkış. Doğrudan alana katılan tüm grupların sayısı.

bool

İsteğe bağlı. Alan yöneticilerinin bu izne sahip olup olmadığı.

bool

İsteğe bağlı. Yönetici olmayan üyelerin bu izne sahip olup olmadığı.

PermissionSetting

İsteğe bağlı. Bir alandaki üyeleri ve grupları yönetme ayarı.

PermissionSetting

İsteğe bağlı. Alan adını, avatarını, açıklamasını ve yönergelerini güncelleme ayarı.

PermissionSetting

İsteğe bağlı. Alan geçmişini etkinleştirmek veya devre dışı bırakmak için kullanılan ayar.

PermissionSetting

İsteğe bağlı. Bir alanda @all ifadesini kullanma ayarı.

PermissionSetting

İsteğe bağlı. Alandaki uygulamaları yönetme ayarı.

PermissionSetting

İsteğe bağlı. Alandaki webhook'ları yönetme ayarı.

PermissionSetting

Yalnızca çıkış. Alanda mesaj yayınlama ayarı.

PermissionSetting

İsteğe bağlı. Alandaki mesajları yanıtlama ayarı.

string

İsteğe bağlı. Alanın açıklaması. Örneğin, alanın tartışma konusunu, işlevsel amacını veya katılımcılarını açıklayın.

En fazla 150 karakter desteklenir.

string

İsteğe bağlı. Alanın kuralları, beklentileri ve görgü kuralları.

En fazla 5.000 karakter desteklenir.

SpaceUpdatedEventData

Güncellenen alanların listesi.

string

Alan etkinliğinin kaynak adı.

Biçim: spaces/{space}/spaceEvents/{spaceEvent}

Timestamp

Etkinliğin gerçekleştiği saat.

string

Alan etkinliğinin türü. Her etkinlik türünün, kısa bir süre içinde gerçekleşen etkinlik türünün birden çok örneğini temsil eden bir toplu sürümü vardır. spaceEvents.list() istekleri için sorgu filtrenizde toplu etkinlik türlerini çıkarın. Sunucu varsayılan olarak hem etkinlik türünü hem de toplu işlem sürümünü döndürür.

Mesajlar için desteklenen etkinlik türleri:

• Yeni mesaj: google.workspace.chat.message.v1.created
• Güncellenen mesaj: google.workspace.chat.message.v1.updated
• Silinen mesaj: google.workspace.chat.message.v1.deleted
• Birden fazla yeni mesaj: google.workspace.chat.message.v1.batchCreated
• Birden fazla güncellenen mesaj: google.workspace.chat.message.v1.batchUpdated
• Birden çok silinen ileti: google.workspace.chat.message.v1.batchDeleted

Üyelikler için desteklenen etkinlik türleri:

• Yeni üyelik: google.workspace.chat.membership.v1.created
• Güncellenen üyelik: google.workspace.chat.membership.v1.updated
• Silinen üyelik: google.workspace.chat.membership.v1.deleted
• Birden fazla yeni üyelik: google.workspace.chat.membership.v1.batchCreated
• Birden fazla güncellenmiş üyelik: google.workspace.chat.membership.v1.batchUpdated
• Birden çok üyelik silindi: google.workspace.chat.membership.v1.batchDeleted

Tepkiler için desteklenen etkinlik türleri:

• Yeni tepki: google.workspace.chat.reaction.v1.created
• Silinen tepki: google.workspace.chat.reaction.v1.deleted
• Birden fazla yeni tepki: google.workspace.chat.reaction.v1.batchCreated
• Birden çok tepki silindi: google.workspace.chat.reaction.v1.batchDeleted

Alan ile ilgili desteklenen etkinlik türleri:

• Güncellenen alan: google.workspace.chat.space.v1.updated
• Birden fazla alan güncellemesi: google.workspace.chat.space.v1.batchUpdated

MessageCreatedEventData

Yeni bir mesaj için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.created

MessageUpdatedEventData

Güncellenen bir ileti için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.updated

MessageDeletedEventData

Silinen bir ileti için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.deleted

MessageBatchCreatedEventData

Birden fazla yeni mesaj için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.batchCreated

MessageBatchUpdatedEventData

Birden fazla güncellenmiş ileti için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.batchUpdated

MessageBatchDeletedEventData

Birden fazla silinen ileti için etkinlik yükü.

Etkinlik türü: google.workspace.chat.message.v1.batchDeleted

SpaceUpdatedEventData

Alan güncellemesi için etkinlik yükü.

Etkinlik türü: google.workspace.chat.space.v1.updated

SpaceBatchUpdatedEventData

Bir alanda yapılan birden fazla güncelleme için etkinlik yükü.

Etkinlik türü: google.workspace.chat.space.v1.batchUpdated

MembershipCreatedEventData

Yeni üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.created

MembershipUpdatedEventData

Güncellenen üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.updated

MembershipDeletedEventData

Silinen üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.deleted

MembershipBatchCreatedEventData

Birden fazla yeni üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.batchCreated

MembershipBatchUpdatedEventData

Birden fazla güncellenmiş üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.batchUpdated

MembershipBatchDeletedEventData

Birden fazla silinen üyelik için etkinlik yükü.

Etkinlik türü: google.workspace.chat.membership.v1.batchDeleted

ReactionCreatedEventData

Yeni bir tepki için etkinlik yükü.

Etkinlik türü: google.workspace.chat.reaction.v1.created

ReactionDeletedEventData

Silinmiş bir tepkinin etkinlik yükü.

Etkinlik türü: google.workspace.chat.reaction.v1.deleted

ReactionBatchCreatedEventData

Birden fazla yeni tepki için etkinlik yükü.

Etkinlik türü: google.workspace.chat.reaction.v1.batchCreated

ReactionBatchDeletedEventData

Birden fazla silinen tepki için etkinlik yükü.

Etkinlik türü: google.workspace.chat.reaction.v1.batchDeleted

string

Tanımlayıcı. Alan bildirimi ayarının kaynak adı. Biçim: users/{user}/spaces/{space}/spaceNotificationSetting.

NotificationSetting

Bildirim ayarı.

MuteSetting

Alan bildirimlerini kapatma ayarı.

string

Alanın okuma durumunun kaynak adı.

Biçim: users/{user}/spaces/{space}/spaceReadState

Timestamp

İsteğe bağlı. Kullanıcının alan okuma durumunun güncellendiği zaman. Bu genellikle son okunan mesajın zaman damgasına veya kullanıcı tarafından bir alandaki son okunan konumu işaretlemek için belirtilen zaman damgasına karşılık gelir.

Space

Güncellenen alan.

string

Tanımlayıcı. İleti dizisinin kaynak adı.

Örnek: spaces/{space}/threads/{thread}

string

İsteğe bağlı. Mesaj dizisi oluşturmak veya güncellemek için giriş. Aksi takdirde yalnızca çıkış. İleti dizisinin kimliği. En fazla 4.000 karakter desteklenir.

Bu kimlik, ayarlayan Chat uygulamasına özgüdür. Örneğin, birden fazla Chat uygulaması aynı mesaj dizisi anahtarını kullanarak bir mesaj oluşturursa mesajlar farklı mesaj dizilerinde yayınlanır. Bir kullanıcı veya başka bir Chat uygulaması tarafından oluşturulan bir mesaj dizisini yanıtlamak için bunun yerine mesaj dizisi name alanını belirtin.

string

İleti dizisinin okunma durumunun kaynak adı.

Biçim: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Timestamp

Kullanıcının ileti dizisi okuma durumunun güncellendiği zaman. Bu değer genellikle bir ileti dizisindeki son okunan mesajın zaman damgasına karşılık gelir.

Membership

Zorunlu. Güncellenecek üyelik. Yalnızca update_mask ile belirtilen alanlar güncellenir.

FieldMask

Zorunlu. Güncellenecek alan yolları. Birden fazla değeri virgülle ayırın veya tüm alan yollarını güncellemek için * kullanın.

Şu anda desteklenen alan yolları:

• role

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.memberships OAuth 2.0 kapsamını gerektirir.

Message

Zorunlu. Alanları güncellenmiş mesaj.

FieldMask

Zorunlu. Güncellenecek alan yolları. Birden fazla değeri virgülle ayırın veya tüm alan yollarını güncellemek için * kullanın.

Şu anda desteklenen alan yolları:

• text

• attachment

• cards (Uygulama kimlik doğrulaması gerekir.)

• cards_v2 (Uygulama kimlik doğrulaması gerekir.)

• accessory_widgets (Uygulama kimlik doğrulaması gerekir.)

bool

İsteğe bağlı. true ve ileti bulunamazsa yeni bir ileti oluşturulur ve updateMask yoksayılır. Belirtilen ileti kimliği istemci tarafından atanmış olmalıdır. Aksi takdirde istek başarısız olur.

SpaceNotificationSetting

Zorunlu. Alan bildirim ayarlarının kaynak adı users/{user}/spaces/{space}/spaceNotificationSetting biçiminde doldurulmalıdır. Yalnızca update_mask ile belirtilen alanlar güncellenir.

FieldMask

Zorunlu. Desteklenen alan yolları: - notification_setting - mute_setting

SpaceReadState

Zorunlu. Alanın okuma durumu ve güncellenecek alanlar.

Yalnızca arayan kullanıcının okuma durumunu güncellemeyi destekler.

Arayan kullanıcıyı belirtmek için aşağıdakilerden birini ayarlayın:

• me takma adı. Örneğin, users/me/spaces/{space}/spaceReadState.

• Workspace e-posta adresleri Örneğin, users/user@example.com/spaces/{space}/spaceReadState.

• Kullanıcı kimliği. Örneğin, users/123456789/spaces/{space}/spaceReadState.

Biçim: users/{user}/spaces/{space}/spaceReadState

FieldMask

Zorunlu. Güncellenecek alan yolları. Şu anda desteklenen alan yolları:

• last_read_time

last_read_time, en son mesajın oluşturulduğu zamandan önceyse alan kullanıcı arayüzünde okunmamış olarak görünür.

Alanı okunmuş olarak işaretlemek için last_read_time değerini, en son mesajın oluşturulduğu zamandan sonraki bir değere (daha büyük) ayarlayın. last_read_time, en son mesajın oluşturulduğu zamanla eşleşecek şekilde zorlanacaktır. Alanın okunma durumunun yalnızca alanın üst düzey ileti dizisinde görünen mesajların okunma durumunu etkilediğini unutmayın. Mesaj dizilerindeki yanıtlar bu zaman damgasından etkilenmez ve bunun yerine ileti dizisinin okunma durumuna bağlıdır.

Space

Zorunlu. Güncellenecek alanları içeren alan. Space.name, spaces/{space} biçiminde doldurulmalıdır. Yalnızca update_mask ile belirtilen alanlar güncellenir.

FieldMask

Zorunlu. Birden fazla alan yolu varsa virgülle ayrılmış güncellenmiş alan yolları.

Alanlar için aşağıdaki alanları güncelleyebilirsiniz:

space_details: Alanın açıklamasını günceller. En fazla 150 karakter desteklenir.

display_name: Yalnızca spaceType alanının SPACE olduğu alanların görünen adını güncellemeyi destekler. ALREADY_EXISTS hata mesajını alırsanız farklı bir değer deneyin. Google Workspace kuruluşunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.

space_type: Yalnızca GROUP_CHAT alan türünün SPACE olarak değiştirilmesini destekler. Güncelleme maskesine space_type ile birlikte display_name öğesini ekleyin ve belirtilen alanın boş olmayan bir görünen ada ve SPACE alan türüne sahip olduğundan emin olun. Mevcut alanda zaten SPACE türü varsa görünen adı güncellerken belirtilen alana space_type maskesini ve SPACE türünü dahil etmek isteğe bağlıdır. Alan türünü başka yöntemlerle güncellemeye çalışmak geçersiz bağımsız değişken hatasına neden olur. space_type, useAdminAccess ile desteklenmez.

space_history_state: Alan için geçmişi etkinleştirerek veya devre dışı bırakarak alan geçmişi ayarlarını günceller. Yalnızca Google Workspace kuruluşu için geçmiş ayarları etkinleştirilmişse desteklenir. Alan geçmişi durumunu güncellemek için isteğinizde diğer tüm alan maskelerini çıkarmanız gerekir. space_history_state, useAdminAccess ile desteklenmez.

access_settings.audience: spaceType alanının SPACE olduğu adlandırılmış alanda, alanı keşfedebilecek, alana katılabilecek ve mesajları önizleyebilecek kullanıcıların erişim ayarını günceller. Mevcut alanın hedef kitlesi varsa bu alan maskesi için bir değer atamadan kitleyi kaldırabilir ve alan erişimini kısıtlayabilirsiniz. Bir alanın erişim ayarlarını güncellemek için kimlik doğrulaması yapan kullanıcının alan yöneticisi olması ve isteğinizde diğer tüm alan maskelerini çıkarması gerekir. Alan içe aktarma modundaysa bu alanı güncelleyemezsiniz. Daha fazla bilgi edinmek için Alanları belirli kullanıcılar tarafından bulunabilir hale getirme başlıklı makaleyi inceleyin. access_settings.audience, useAdminAccess ile desteklenmez.

permission_settings: Alanın izin ayarlarının değiştirilmesini destekler. İzin ayarlarını güncellerken yalnızca permissionSettings alan maskelerini belirtebilirsiniz. Aynı anda diğer alan maskelerini güncelleyemezsiniz. permissionSettings, useAdminAccess ile desteklenmez. Desteklenen alan maskeleri şunlardır:

• permission_settings.manageMembersAndGroups
• permission_settings.modifySpaceDetails
• permission_settings.toggleHistory
• permission_settings.useAtMentionAll
• permission_settings.manageApps
• permission_settings.manageWebhooks
• permission_settings.replyMessages

bool

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces OAuth 2.0 kapsamını gerektirir.

Bazı FieldMask değerleri, yönetici erişimi kullanılarak desteklenmez. Ayrıntılı bilgi için update_mask açıklamasına bakın.

string

Google Chat user kaynağının adı.

Biçim: users/{user}. users/app, bot kullanıcısının arayan uygulama takma adı olarak kullanılabilir.

human users için {user}, aşağıdakilerle aynı kullanıcı tanımlayıcısıdır:

• People API'deki kişi için id. Örneğin, Chat API'deki users/123456789, People API'deki 123456789 kişi profili kimliğiyle aynı kişiyi temsil eder.

• Yönetici SDK'sı Directory API'de kullanıcı için id.

• Kullanıcının e-posta adresi, API isteklerinde {user} için takma ad olarak kullanılabilir. Örneğin, user@example.com için People API kişi profili kimliği 123456789 ise users/123456789'e referans vermek üzere users/user@example.com takma adını kullanabilirsiniz. API'den yalnızca kurallı kaynak adı (örneğin, users/123456789) döndürülür.

string

Yalnızca çıkış. Kullanıcının görünen adı.

string

Kullanıcının Google Workspace alanının benzersiz tanımlayıcısı.

Type

Kullanıcı türü.

bool

Yalnızca çıkış. true olduğunda kullanıcı silinir veya profili görünmez.

User

Bahsedilen kullanıcı.

Type

Kullanıcının türü.

Button

Düğme listesi. Düğmeler de oneof data'dir ve bu alanlardan yalnızca biri ayarlanmalıdır.

TextParagraph

Bu widget'ta bir metin paragrafı gösterin.

Image

Bu widget'ta bir resim gösterin.

KeyValue

Bu widget'ta bir anahtar/değer öğesi gösterin.

TextButton

Metin ve onclick işlemi içeren bir düğme.

ImageButton

Resim ve onclick işlemi içeren bir düğme.

string

Yöntem adı, form gönderimini tetikleyen formun hangi bölümünü tanımlamak için kullanılır. Bu bilgiler, kart tıklama etkinliğinin bir parçası olarak Chat uygulamasına geri gönderilir. Ortak bir davranışı tetikleyen birden fazla öğe için aynı yöntem adını kullanabilirsiniz.

ActionParameter

İşlem parametrelerinin listesi.

string

İşlem komut dosyası için parametrenin adı.

string

Parametrenin değeri.

string

Resmin URL'si.

OnClick

onclick işlemi.

double

Bu resmin en boy oranı (genişlik ve yükseklik). Bu alan, resmin yüklenmesini beklerken resim için doğru yüksekliği ayırmanıza olanak tanır. Bu, resmin yerleşik en boy oranını geçersiz kılmak için değildir. Ayarlanmamışsa sunucu, resmi önceden alarak doldurur.

OnClick

onclick işlemi.

string

Erişilebilirlik için kullanılan bu image_button öğesinin adı. Bu ad belirtilmezse varsayılan değer sağlanır.

Icon

Chat API tarafından sağlanan bir simgeyi dizine ekleyen enum ile belirtilen simge.

string

URL ile belirtilen simge.