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
}
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 bir alanın alan türünü güncellerken gereklidir. Yalnızca başka kullanım 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 öğesini 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 alanın herhangi bir Google Chat kullanıcısına üye olarak izin verip vermediği. Bir Google Workspace kuruluşunda alan oluştururken giriş yapın. Aşağıdaki koşullarda boşluk oluştururken bu alanı atlayın:

  • Kimliği doğrulanmış kullanıcı bir Google Hesabı kullanıyor. Varsayılan olarak alanda tüm Google Chat kullanıcılarına izin verilir.

  • Alan, Google Chat'e veri aktarmak için kullanılır. İçe aktarma modundaki alanlar, yalnızca aynı Google Workspace kuruluşundan üyelere izin vermelidir.

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

spaceThreadingState

enum (SpaceThreadingState)

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

spaceDetails

object (SpaceDetails)

Açıklama ve kurallar da 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 Import Mode konumunda Google Workspace'e veri taşıma işlemi kapsamında oluşturulup oluşturulmadığı. Alanlar, içe aktarılırken, içe aktarma işlemi tamamlanana kadar kullanıcılara gösterilmez.

createTime

string (Timestamp format)

İsteğe bağlı. Chat'te oluşturulan alanlar için, alanın oluşturulduğu zaman. Bu alan, içe aktarılan alanlarda kullanıldığı durumlar dışında yalnızca çıkış işlevi görür.

İçe aktarılan alanlarda, orijinal oluşturma zamanını korumak için bu alanı alanın kaynakta oluşturulduğu geçmiş zaman damgasına ayarlayın.

Çıkış, yalnızca spaceType değeri GROUP_CHAT veya SPACE olduğunda 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, Chat uygulamalarını yalnızca kullanıcılar ile uygulama arasında doğrudan mesajlaşma için yükleyebilir. Yönetici haklarıyla yükleme yapılabilmesi için uygulamanızda doğrudan mesajlaşma özelliği bulunmalıdır.

Type

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 ile Chat uygulaması arasındaki teke tek doğrudan mesaj, tüm mesajlar düzdür. Bunun iki kişi arasındaki doğrudan mesajları kapsamadığını lütfen unutmayın.

Alan Türü

Alanın türü. Alan oluştururken veya güncellerken gereklidir. Yalnızca başka kullanım için çıkış yapar.

Sıralamalar
SPACE_TYPE_UNSPECIFIED Ayırtı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 kişi veya bir insan ile bir Chat uygulaması arasındaki 1:1 mesajlar.

SpaceThreadingState

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

Sıralamalar
SPACE_THREADING_STATE_UNSPECIFIED Ayırtıldı.
THREADED_MESSAGES Mesaj dizilerini destekleyen adlandırılmış alanlar. Kullanıcılar bir mesaja yanıt verdiğinde mesaj dizisi içinde yanıt verebilir, böylece yanıtlarını orijinal mesajın bağlamında tutar.
GROUPED_MESSAGES Görüşmenin konuya göre düzenlendiğ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'ler), 3 veya daha fazla kişi arasındaki grup görüşmeleridir.

Alan Ayrıntıları

Açıklama ve kurallar da 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 destekler.

guidelines

string

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

5.000 karaktere kadar destekler.

GeçmişDurumu

Mesajlar ve alanların geçmiş durumu. İletilerin ve görüşme ileti dizilerinin oluşturulduktan sonra ne kadar süre 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.

Yöntemler

completeImport

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

create

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

delete

Adlandırılmış bir alanı siler.

findDirectMessage

Belirtilen kullanıcıyla olan 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.