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önetim Aracı'nı kullanabilir veya Google Chat API'yi çağırabilir. Yöneticiler, Chat API'yi kullanarak alanları geniş ölçekte yöneten ve sık veya tekrarlanan görevlerini otomatikleştiren 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 yetkiyi alan genelinde yetkilendirme yaparak isteklerin kimliğini doğrulayabilir ve yetkilendirebilir.

Aşağıdaki tabloda, yöneticilerin Chat API'yi kullanırken kimlik doğrulama yöntemleri açıklanmaktadır.

Kullanıcı kimlik doğrulaması API yöntemini çağıranlar Kullanıcılar Chat'te ne görür?
Yönetici ayrıcalıkları useAdminAccess=true kullanan 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ı, kullanıcı kimliğini veya Chat 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, "Selin T, alanı "Proje Yayınlama Tartışması" olarak yeniden adlandırdı."

Hizmet tarafından kimliğine bürünen kullanıcının işlemi gerçekleştirdiği anlaşılır.

Kuruluşunuz için Chat API'yi kullanma

Bu bölümdeki örneklerde, yöneticilerin yönetici ayrıcalıklarına sahip olarak kuruluşlarının alanlarını ve üyelerini yönetirken Chat API'yi nasıl kullandıkları 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()'i kullanarak kuruluştaki herhangi bir alana kullanıcı ekleyebilir.

Yöneticiler, spaces.search() ile birlikte kullanıldığında kullanıcıları arama sorgularına göre belirlenen bir dizi alana ekleyebilir. Bu, kuruluşa yeni katılan çalışanlara ilk katılım sırasında faydalı olabilir. Yöneticilerin rutin bir süreci otomatikleştirmesine olanak tanır.

Kullanıcıları bulup alanlardan kaldırma

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

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

Kullanıcıları alan yöneticisi olarak atama

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

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

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 üyesi olan kullanıcılar için filtreleyebilir. Daha fazla bilgi için Chat'in kullanıcıları nasıl tanımladığı başlıklı makaleyi inceleyin.

Alanları denetleme ve yönetme

Aşağıdaki senaryolarda, Google Workspace yöneticisi olarak Chat API ile kuruluşunuzdaki alanları denetleme ve yönetme yöntemleri açıklanmaktadır.

Etkin olmayan alanları bulma ve silme

Kullanılmayan Chat alanları, değerli depolama alanı kaplar ve kullanıcı arayüzünde dağınıklığa neden olabilir. Yöneticiler, etkin olmayan alanları bulmak için spaces.search() simgesini, silmek için ise spaces.delete() simgesini kullanabilir. Daha fazla bilgi ve kod örneği için Etkin olmayan Chat alanlarını bulma ve silme başlıklı makaleyi inceleyin.

Kuruluştaki alanları denetleme

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

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

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

Arama ölçütlerine göre bir alanın üyelerini bulma

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

Alan yöneticilerini bulma

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

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