Google Workspace yöneticisi olarak Google Chat alanlarını yönetme

Bu sayfada, Google Workspace yöneticilerinin kuruluşlarındaki Google Chat alanlarını yönetmek için Google Chat API'yi nasıl kullanabileceğine dair genel bilgiler verilmektedir.

Google Workspace yöneticileri, Chat alanlarını yönetmek için Google Yönetici Konsolu'ndaki Alan Yönetimi Aracı'nı kullanabilir veya Google Chat API'sini çağırabilir. Yöneticiler, Chat API'yi kullanarak alanları geniş ölçekte yöneten ve sık yapılan ya da tekrarlanan görevlerini otomatik hale getiren Google Chat uygulamaları oluşturabilir.

Yöneticiler Chat API ile neler yapabilir?

Yöneticiler, atanan yönetici rollerine göre yönetim görevlerini gerçekleştirebilir.

Google Workspace yöneticisi olarak Chat API ile aşağıdakiler gibi çeşitli yönetim görevlerini gerçekleştirebilirsiniz:

Google Workspace yöneticisi olarak kimlik doğrulama ve yetkilendirme

Yöneticiler, yönetim görevleri için Chat API'yi kullanırken yönetici ayrıcalıklarını çağırarak veya bir uygulamanın hizmet hesabı için alan genelinde yetki devrini yapılandırarak isteklerin kimliğini doğrulayabilir ve istekleri yetkilendirebilir.

Aşağıdaki tabloda, yöneticilerin Chat API'yi kullanırken kimliklerini doğrulayabilecekleri yöntemler açıklanmaktadır.

Kullanıcı kimlik doğrulaması API yöntemini kim çağırıyor? Kullanıcılar Chat'te ne görür?
Yönetici ayrıcalıkları useAdminAccess=true olan yönetici

"Kuruluşun yöneticisi [bir işlem] gerçekleştirdi."

Örneğin, "Kuruluşun yöneticisi, Kiran B'nin rolünü alan yöneticisi olarak değiştirdi."

Yönetici kullanıcının adını veya kullanıcı kimliğini ya da sohbet uygulamasının adını tanımlamaz.
Alan genelinde yetki Kullanıcı adına hizmet hesabı

"[Kullanıcı], [uygulama adı] üzerinden [bir işlem] gerçekleştirdi."

Örneğin, "Sasha T, alanı Yayın Projesi Tartışması olarak yeniden adlandırdı."

Hizmet tarafından kimliğine bürünülen kullanıcı, işlemi gerçekleştiren olarak tanımlanır.

Kuruluşunuz için Chat API'yi kullanma

Bu bölümdeki örneklerde, yöneticilerin kuruluşlarının alanlarını ve üyelerini yönetici ayrıcalıklarıyla yönetirken Chat API'yi nasıl kullandığı gösterilmektedir.

Aşağıdaki Chat API yöntemleri, useAdminAccess=true ile yönetici ayrıcalıklarını etkinleştirir.

Kullanıcıların alan üyeliklerini yönetme

Aşağıdaki senaryolar, Google Workspace yöneticisi olarak kuruluşunuzdaki kullanıcıların alan üyeliğini Chat API ile yönetebileceğiniz yöntemlerdir.

Alanlara kullanıcı ekleme

Yöneticiler, spaces.members.create() simgesini kullanarak bir kullanıcıyı kuruluştaki herhangi bir alana ekleyebilir.

spaces.search() ile birlikte kullanıldığında yöneticiler, arama sorgularına göre belirlenen bir grup alana kullanıcı ekleyebilir. Bu özellik, yeni çalışanları kuruluşa dahil ederken yararlı olabilir. Yöneticilerin rutin bir süreci otomatikleştirmesine olanak tanır.

Kullanıcıları bulma ve alanlardan kaldırma

Yöneticiler, spaces.members.get() kullanarak bir kullanıcının (kuruluşun içinden veya dışından) kuruluştaki herhangi bir alanın üyesi olup olmadığını belirleyebilir.

spaces.search() ile birlikte kullanılan bu özellik sayesinde yöneticiler, kullanıcının üyesi olduğu tüm alanları bulabilir ve ardından spaces.members.delete() ile kullanıcıyı bu alanlardan kaldırabilir. Bu özellik, çalışanlar kuruluş içinde ekipler arasında geçiş yaptığında veya kuruluşta artık çalışmayan çalışanların işten ayrılma sürecinde yararlı olabilir. Yöneticilerin rutin bir süreci otomatikleştirmesine olanak tanır.

Kullanıcıları alan yöneticisi olarak yükseltme

Yöneticiler, spaces.members.patch()'ı kullanarak bir alanın üyelerini ROLE_MEMBER rolünden ROLE_MANAGER rolüne yükseltebilir. Yöneticiler, üyeleri ROLE_MANAGER'den ROLE_MEMBER'ye taşımak için spaces.members.patch() simgesini de kullanabilir.

spaces.search() ile birlikte kullanıldığında yöneticiler, yöneticisi olmayan alanları bulabilir ve mevcut bir üyeyi spaces.members.patch() ile ROLE_MANAGER'e yükseltebilir.

Bir alanın harici üyelerini bulma

Yöneticiler, spaces.members.list()'i kullanarak bir alandaki üyelerin listesini alabilir, kuruluşun People API'sinden veya Directory API'sinden kullanıcı profillerini alabilir ve ardından sonuçları harici bir alanın veya kuruluşun üyeleri için filtreleyebilir. Daha fazla bilgi için Chat, kullanıcıları nasıl tanımlar? başlıklı makaleyi inceleyin.

Alanları denetleme ve yönetme

Aşağıdaki senaryolar, Google Workspace yöneticisi olarak kuruluşunuzdaki alanları Chat API ile denetleyip yönetebileceğiniz yöntemlerdir.

Etkin olmayan alanları bulma ve silme

Kullanılmayan Chat alanları değerli depolama alanını kaplayabilir ve kullanıcı arayüzünde karmaşa oluşturabilir. Yöneticiler, etkin olmayan alanları bulmak için spaces.search() ve bunları silmek için spaces.delete() seçeneğini kullanabilir. Daha fazla bilgi ve kod örneği için Etkin olmayan Chat alanlarını bulma ve silme başlıklı makaleyi inceleyin.

Kuruluşta alanları denetleme

Yöneticiler, spaces.search() simgesini kullanarak bir kuruluştaki tüm alanların listesini alabilir. Bu listede, her alanın ayarları ve meta verileri (ör. oluşturma tarihi, son etkinlik tarihi, üye sayısı, geçmiş ayarının durumu ve harici misafirleri davet etme özelliği) hakkında ayrıntılı bilgiler yer alır.

Arama ölçütlerine göre alan listesini dışa aktarma

Yöneticiler, spaces.search()'ı kullanarak query'da belirtilen ölçütleri karşılayan alanların listesini alabilir ve sonuçları analiz için CSV dosyasına aktarabilir.

Arama ölçütlerine göre alan üyelerini bulma

Yöneticiler, spaces.members.list() kullanarak kuruluşta herhangi bir alanın üye listesini alabilir ve sonuçları belirli ölçütlere göre analiz edebilir.

Bir alanın yöneticilerini bulma

Yöneticiler, spaces.members.list() kullanarak MembershipState=ROLE_MANAGER ile filtrelenmiş bir alanın üye listesini alabilir.

Kuruluşunuzdaki tüm alan yöneticilerini, tüm alanlarda bulmak için spaces.search() simgesini kullanarak hepsini listeleyebilirsiniz. Ardından, listedeki her alan için spaces.members.list kullanarak yöneticileri alın.