REST Resource: spaces.members

Kaynak: Üyelik

Google Chat'teki üyelik ilişkisini (ör. bir kullanıcının veya Chat uygulamasının bir alana davet edilip edilmediği, alanda yer alıp almadığı ya da alanda bulunmadığı) gösterir.

JSON gösterimi
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,
  "affiliation": enum (Affiliation),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
Alanlar
name

string

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

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

state

enum (MembershipState)

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

role

enum (MembershipRole)

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

Bu alan yalnızca members.patch içinde giriş olarak kullanılabilir.

createTime

string (Timestamp format)

İsteğe bağlıdır. Değiştirilemez. Üyeliğin oluşturulma zamanı (ör. bir üyenin alana katıldığı veya alana katılmaya davet edildiği zaman) Bu alan, içe aktarma modundaki alanlara geçmiş üyelikleri aktarmak için kullanılması dışında yalnızca çıkış olarak kullanılır.

deleteTime

string (Timestamp format)

İsteğe bağlıdır. Değiştirilemez. Üyeliğin silinme zamanı (ör. bir üye alandan ayrıldığında veya çıkarıldığında) Bu alan, içe aktarma modundaki alanlara geçmiş üyelikleri aktarmak için kullanılması dışında yalnızca çıkış olarak kullanılır.

affiliation

enum (Affiliation)

Yalnızca çıkış. Kullanıcının, alanı oluşturan Workspace kuruluşuyla ilişkisi. Tüketici hesaplarına ait alanlarda tüm üyelerin bağlılığı EXTERNAL olur.

Bu üyelikle ilişkili üye. Gelecekte diğer üyelik türleri de desteklenebilir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
member

object (User)

İsteğe bağlıdır. Üyeliğin karşılık geldiği Google Chat kullanıcısı veya uygulaması. Chat uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa, alanın üyesi olmadıkları veya arayan kullanıcıyla doğrudan mesaj (DM) görüşmesi gibi önceden bir yakınlıkları olmadığı sürece hem kuruluş içi hem de kuruluş dışı kullanıcılar için çıkış yalnızca user name ve type alanlarını doldurur.

groupMember

object (Group)

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

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

Birbirini dışlayan alanların sonu.

MembershipState

Üyenin alanla ilişkisini belirtir. Gelecekte diğer üye devletler de desteklenebilir.

Sıralamalar
MEMBERSHIP_STATE_UNSPECIFIED Varsayılan değer. Kullanmayın.
JOINED Kullanıcı alana eklenir ve alana katılabilir.
INVITED Kullanıcı, alana katılmaya davet edilmiş ancak katılmamıştır.
NOT_A_MEMBER Kullanıcı alana ait değil ve alana katılmak için bekleyen bir davetiye almadı.

MembershipRole

Bir kullanıcının Chat alanında yapmasına izin verilen işlemleri gösterir. Gelecekte daha fazla enum değeri eklenebilir.

Sıralamalar
MEMBERSHIP_ROLE_UNSPECIFIED Varsayılan değer. users için: Kullanıcı, alanın üyesi değildir ancak davet edilebilir. Google Groups için: Bu rol her zaman atanır (gelecekte diğer enum değerleri kullanılabilir).
ROLE_MEMBER

Alan üyesi Sohbet kullanıcı arayüzünde bu role Üye adı verilir.

Kullanıcı, alana mesaj gönderme gibi temel izinlere sahip olmalıdır. Yöneticiler ve sahipler, üyelere alanda aşağıdaki gibi ek izinler verebilir:

  • Üye ekleme veya kaldırma
  • Alan ayrıntılarını değiştirme
  • Geçmişi etkinleştirme veya devre dışı bırakma
  • @all ile alandaki herkesten bahsedin.
  • Alana yüklenen Chat uygulamalarını ve webhook'ları yönetebilirsiniz.

Doğrudan mesajlarda ve adsız grup görüşmelerinde herkes bu role sahiptir.

ROLE_MANAGER

Alan sahibi Sohbet kullanıcı arayüzünde bu role Sahip adı verilir.

Kullanıcı, alanı yönetmek için gereken tüm alan izinlerine sahip olmalıdır. Bu izinler şunlardır:

  • Alanın diğer üyelerinin rollerini üye, yönetici veya sahip olarak değiştirme
  • Alanı silin.

Yalnızca SpaceType.SPACE (adlandırılmış alanlar) içinde desteklenir.

Daha fazla bilgi için Alan sahibi veya yöneticisi rolünüz hakkında daha fazla bilgi başlıklı makaleyi inceleyin.

ROLE_ASSISTANT_MANAGER

Alan yöneticisi Chat kullanıcı arayüzünde bu role "Yönetici" adı verilir.

Kullanıcı, ROLE_MEMBER ile ilgili tüm temel izinlere sahiptir ve bir sahip tarafından yönetici izinlerinin bir alt kümesi verilebilir. Yöneticiler, varsayılan olarak sahibin tüm izinlerine sahiptir. Ancak aşağıdaki işlemleri yapamazlar:

  • Alanı silin.
  • Başka bir alan üyesini sahip yapma
  • Sahibin rolünü değiştirme

Yöneticilerin izinleri varsayılan olarak aşağıdakileri içerir ancak bunlarla sınırlı değildir:

  • Başka bir üyeyi yönetici yapma
  • Alandaki mesajları silme
  • Alan izinlerini yönetme
  • Yönetici, alan ayarlarında "üyeleri yönet" iznine sahipse alana katılma istekleriyle ilgili bildirimler alma
  • Bir alanı herkese açık hâle getirme

Yalnızca SpaceType.SPACE (adlandırılmış alanlar) içinde desteklenir.

Daha fazla bilgi için Alan ayarlarını yönetme başlıklı makaleyi inceleyin.

Grup

Google Chat'te bir Google Grubu.

JSON gösterimi
{
  "name": string
}
Alanlar
name

string

Google Grubu'nun kaynak adı.

Cloud Identity Groups API'deki bir grubu temsil eder.

Biçim: groups/{group}

İlişkilendirme

Bir kullanıcının, alanın sahibi olan Google Workspace kuruluşuyla ilişkisini gösterir. Bu enum'a gelecekte daha fazla değer eklenebilir.

Sıralamalar
AFFILIATION_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
INTERNAL Alan sahibiyle aynı Google Workspace kuruluşu tarafından yönetilen bir hesap
EXTERNAL Alan sahibi Google Workspace kuruluşunun dışındaki bir hesap (ör. tüketici hesabı veya farklı bir Workspace kuruluşu tarafından yönetilen hesap)
MANAGED_EXTERNAL Alan sahibi Workspace kuruluşu tarafından yönetilen ancak kuruluş dışındaki bir kullanıcı (ör. misafir kullanıcı) için sağlanan bir hesap. Konuklar hakkında daha fazla bilgi edinmek için https://support.google.com/chat/answer/16997417 adresini ziyaret edin.

Yöntemler

create

Arama için Chat uygulaması, bir kullanıcı veya Google Grubu için üyelik oluşturur.

delete

Üyeliği siler.

get

Üyelik hakkında ayrıntılar döndürür.

list

Bir alandaki üyelikleri listeler.

patch

Üyeliği günceller.