REST Resource: spaces

Kaynak: Alan

Google Chat'te bir alan. Alanlar, iki veya daha fazla kullanıcı arasındaki görüşmeler ya da kullanıcı ile Chat uygulaması arasındaki bire bir mesajlardır.

JSON gösterimi
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "adminInstalled": boolean,
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string
}
Alanlar
name

string

Alanın kaynak adı.

Biçim: spaces/{space}

type
(deprecated)

enum (Type)

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine spaceType kullanın. Alanın türü.

spaceType

enum (SpaceType)

Alanın türü. Alan oluştururken veya alanın alan türünü güncellerken gereklidir. Yalnızca diğer kullanımlar için çıkış yapar.

singleUserBotDm

boolean

İsteğe bağlı. Alanın, Chat uygulaması ile tek bir insan arasındaki DM olup olmadığı.

threaded
(deprecated)

boolean

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine spaceThreadingState kullanın. Bu alandaki mesajların mesaj dizisi halinde olup olmadığı.

displayName

string

Alanın görünen adı. Alan oluştururken gereklidir. Alan oluştururken veya displayName güncellerken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName deneyin. Google Workspace kuruluşundaki mevcut bir alan, bu görünen adı zaten kullanıyor olabilir.

Doğrudan mesajlar için bu alan boş olabilir.

128 karaktere kadar destekler.

externalUserAllowed

boolean

Sabit. Bu alanda herhangi bir Google Chat kullanıcısına üye olarak izin verilip verilmediği. Bir Google Workspace kuruluşunda alan oluştururken giriş yapın. Aşağıdaki koşullarda alan oluştururken bu alanı atlayın:

  • Kimliği doğrulanan kullanıcı bir tüketici hesabı (yönetilmeyen kullanıcı hesabı) kullanır. Varsayılan olarak, tüketici hesabı tarafından oluşturulan bir alanda tüm Google Chat kullanıcılarına izin verilir.

  • İçe aktarma modundaki alanlar yalnızca aynı Google Workspace kuruluşundan üyelere izin vermelidir. Bu nedenle alan, Google Chat'e veri aktarmak için kullanılır. Ancak, Google Workspace Geliştirici Önizleme Programı kapsamında, içe aktarma modundaki alanlar herhangi bir Google Chat kullanıcısına izin verebilir. Böylece bu alan, içe aktarma modundaki alanlar için ayarlanabilir.

Mevcut alanlar için bu alan yalnızca çıktı biçimindedir.

spaceThreadingState

enum (SpaceThreadingState)

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

spaceDetails

object (SpaceDetails)

Açıklama ve kurallar dahil olmak üzere alanla ilgili ayrıntılar.

spaceHistoryState

enum (HistoryState)

Bu alandaki mesajlar ve mesaj dizileri için mesaj geçmişi durumu.

importMode

boolean

İsteğe bağlı. Bu alanın Google Workspace'e veri taşıma kapsamında Import Mode konumunda 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.

createTime

string (Timestamp format)

İsteğe bağlı. Sabit. Chat'te oluşturulan alanlar için, alanın oluşturulduğu zaman. Bu alan, içe aktarma modundaki alanlarda kullanılmadığı sürece yalnızca çıkış bilgisi verir.

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

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

adminInstalled

boolean

Yalnızca çıkış. Chat uygulamasının bir Google Workspace yöneticisi tarafından yüklenip yüklenmediği. Yöneticiler; alanları, kuruluş birimleri veya bir kullanıcı grubu için Chat uygulaması yükleyebilir.

Yöneticiler, yalnızca kullanıcılarla uygulama arasında doğrudan mesajlaşmak için Chat uygulamalarını yükleyebilir. Yönetici yüklemeyi desteklemek için uygulamanızda doğrudan mesajlaşma özelliği bulunmalıdır.

accessSettings

object (AccessSettings)

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

spaceUri

string

Yalnızca çıkış. Alanın URI'si.

Tür

Kullanımdan kaldırıldı: Bunun yerine SpaceType kullanın.

Sıralamalar
TYPE_UNSPECIFIED
ROOM İki veya daha fazla insan arasındaki konuşmalar.
DM İnsan ve Chat uygulaması arasında yapılan, tüm mesajların sabit olduğu bire bir doğrudan mesaj. Bunun iki kişi arasındaki doğrudan mesajları kapsamadığını unutmayın.

SpaceType

Alanın türü. Alan oluştururken veya güncellerken gereklidir. Yalnızca diğer kullanımlar için çıkış yapar.

Sıralamalar
SPACE_TYPE_UNSPECIFIED Ayrıldı.
SPACE Kullanıcıların ileti gönderdiği, dosya paylaştığı ve ortak çalışma yaptığı bir yer. SPACE, Chat uygulamaları içerebilir.
GROUP_CHAT 3 veya daha fazla kişinin yer aldığı grup görüşmeleri. GROUP_CHAT, Chat uygulamaları içerebilir.
DIRECT_MESSAGE İki gerçek kişi veya bir insan ile Chat uygulaması arasındaki 1:1 mesajlar.

SpaceThreadingState

Chat alanındaki mesaj dizisi durumunun türünü belirtir.

Sıralamalar
SPACE_THREADING_STATE_UNSPECIFIED Ayrıldı.
THREADED_MESSAGES Mesaj dizilerini destekleyen adlandırılmış alanlar. Kullanıcılar bir mesajı yanıtladığında, mesaj dizisi içinde yanıt verebilir. Böylece, yanıtları orijinal mesajın bağlamı içinde kalır.
GROUPED_MESSAGES Görüşmenin konuya göre organize edildiği adlandırılmış alanlar. Konular ve yanıtları birlikte gruplandırılır.
UNTHREADED_MESSAGES İki kişi arasındaki doğrudan mesajlar (DM) ve 3 veya daha fazla kişi arasındaki grup görüşmeleri.

SpaceDetails

Açıklama ve kurallar dahil olmak üzere alanla ilgili ayrıntılar.

JSON gösterimi
{
  "description": string,
  "guidelines": string
}
Alanlar
description

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ı açıklayın.

150 karaktere kadar desteklenir.

guidelines

string

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

5.000 karaktere kadar desteklenir.

HistoryState

Mesajlar ve alanların geçmiş durumu. Mesajların ve ileti dizilerinin oluşturulduktan sonra ne kadar süreyle saklanacağını belirtir.

Sıralamalar
HISTORY_STATE_UNSPECIFIED Varsayılan değer. Kullanmayın.
HISTORY_OFF Geçmişe kayıt kapalı. Mesajlar ve mesaj dizileri 24 saat saklanır.
HISTORY_ON Geçmişe kayıt açık. Kuruluşun Apps Kasası saklama kuralları, iletilerin ve ileti dizilerinin ne kadar süre saklanacağını belirtir.

AccessSettings

Alanın erişim ayarını temsil eder.

JSON gösterimi
{
  "accessState": enum (AccessState),
  "audience": string
}
Alanlar
accessState

enum (AccessState)

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

audience

string

İsteğe bağlı. Alana erişebilen hedef kitlenin kaynak adı. Alanı bulunabilir hale getirmek için bu alanı geçerli bir hedef kitle kimliğine ayarlayın veya audiences/default takma adını kullanarak alanı Yönetici Konsolu'nda varsayılan erişim ayarıyla ayarlayın. Daha fazla bilgi edinmek için Bir alanı hedef kitle için bulunabilir hale getirme başlıklı makaleyi inceleyin. Alanı kısıtlanmış hâle getirmek için bu alanın ayarını kaldırın. Yalnızca alan bulunabilir olduğunda doldurulur. Biçim: audiences/{audience}, audiences/default varsayılan Chat Paylaşım ayarının takma adı olarak kullanılabilir.

AccessState

Alanın erişim durumunu gösterir.

Sıralamalar
ACCESS_STATE_UNSPECIFIED Erişim durumu bilinmiyor veya bu API'de desteklenmiyor.
PRIVATE Alan, eklenen veya davet edilen üyeler ya da gruplar tarafından bulunabilir.
DISCOVERABLE Alan, seçilen veya davet edilen üye ya da grupların yanı sıra seçilen hedef kitle tarafından da bulunabilir.

Yöntemler

completeImport

Belirtilen alan için içe aktarma işlemini tamamlar ve alan adı kullanıcılara görünür hale gelir.

create

Adlandırılmış alan oluşturur.

delete

Adlandırılmış alanı siler.

findDirectMessage

Belirtilen kullanıcıyla olan mevcut doğrudan mesajı döndürür.

get

Bir alanla ilgili ayrıntıları döndürür.

list

Arayanın üyesi olduğu alanları listeler.

patch

Bir alanı günceller.

setup

Bir alan oluşturur ve belirtilen kullanıcıları alana ekler.