Bir Google Chat alanını bir Google Workspace kuruluşundaki belirli kullanıcılar tarafından bulunabilir hale getirme

Bu sayfada, Google Chat API'yi kullanarak Google Workspace kuruluşundaki belirli kullanıcılarla Google Chat alanı paylaşma açıklanmaktadır. Böylece kullanıcılar, alanı keşfedebilir, alana katılabilir ve alan üyelerini görüntüleyebilir.

Kuruluşunuzda bir alanı keşfedebilecek, alana katılabilecek ve alan üyelerini görüntüleyebilecek kullanıcıları belirtmek için hedef kitleler oluşturursunuz. Hedef kitle, belirli departmanlar veya kuruluşun tamamı gibi bir grup kullanıcıdır. Bu kullanıcılarla bir sohbet alanı paylaşarak alana ve bilgilerine kimlerin erişebileceği konusunda daha ayrıntılı kontrol sağlayabilirsiniz. Hedef kitleler, tek tek kullanıcıları bir alana davet etmenize gerek kalmadan alan üyeliklerini yönetmenize ve özelleştirmenize de olanak tanır. Daha fazla bilgi için Hedef kitleler hakkında başlıklı makaleyi inceleyin.

Yalnızca adlandırılmış alanları hedef kitleler için herkese açık hale getirebilirsiniz. Doğrudan mesajlar veya grup görüşmeleri gibi diğer alan türlerini hedef kitlelerle paylaşamazsınız.

Ön koşullar

Hedef kitle kimliğini alma

Bir hedef kitlenin kimliğini almak için aşağıdakileri yapın:

  1. Google Yönetici Konsolu'nda Menü > Dizin > Hedef kitleler'e gidin.

    Hedef kitleler'e gidin

  2. Hedef kitleler tablosunda, hedef kitlenin Ad alanını tıklayın.

  3. Hedef kitle kimliğini sayfanın URL'sinde bulun. URL biçimi şöyledir: https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, burada TARGET_AUDIENCE_ID, hedef kitlenizin alfanümerik kimliğidir.

Sonraki bölümde, hedef kitle kimliğini kullanarak keşfedilebilir bir alan oluşturabilir veya mevcut bir alanı hedef kitle tarafından keşfedilebilir hâle getirmek için güncelleyebilirsiniz.

Hedef kitleleri ve ayrıntılı izinleri belirtme

Belirli erişim izinlerine sahip bir alan oluşturmak için Space kaynağında create veya setup yöntemini kullanın. Mevcut bir alanın izinlerini güncellemek için update yöntemini kullanın. Yalnızca adlandırılmış alanlar hedef kitlelerle paylaşılabildiğinden alan türü (spaceType alanında gösterilir) SPACE olmalıdır.

Bir alanı kimlerin keşfedebileceğini, alana kimlerin katılabileceğini veya alan üyelerini kimlerin görüntüleyebileceğini belirtmek için Space kaynağına AccessSettings nesnesini ekleyin. Nesnede, aşağıdaki izinlerden birini veya daha fazlasını belirtmek için accessPermissionSettings alanını kullanın:

  • Bulunabilir: Bir alanın adını ve açıklamasını kimlerin bulabileceğini ve Google Chat'te alana kimlerin göz atabileceğini tanımlamak için discoverSpaceSetting simgesini kullanın. Keşif için birden fazla hedef kitle belirtebilirsiniz.
  • Katılınabilir: joinSpaceSetting simgesini kullanarak açık davet olmadan alana kimlerin katılabileceğini tanımlayın ve alan mesajını önizleyin. Bir alana katılabilen kullanıcılar, bu alanı keşfedebilmelidir. Google Chat, bu izin için tek bir hedef kitleyi destekler.
  • Üyeliği görüntüleme: Bir alandaki üye listesini kimlerin görebileceğini tanımlamak için viewSpaceMembershipSetting simgesini kullanın. Alan üyeliğini kimlerin görüntüleyebileceğini güncellerken hem updateMask hem de istek gövdesinde permissionSettings.viewSpaceMembership ile birlikte accessSettings.accessPermissionSettings.viewSpaceMembershipSetting belirtilmelidir. viewSpaceMembershipSetting içinde bir hedef kitle yapılandırıldığında tüm üyelere viewSpaceMembership izni verilmelidir (managersAllowed, assistantManagersAllowed ve membersAllowed, true olarak ayarlanır).

Aşağıdaki örnekte, bir alanın iki hedef kitle tarafından bulunabilmesini, alana bu hedef kitlelerden yalnızca birinin katılabilmesini ve tüm üyelerin ve belirtilen hedef kitlelerin üye listesini görüntüleyebilmesini sağlamanın nasıl mümkün olduğu gösterilmektedir:

{
  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

TARGET_AUDIENCE_ID_1 ve TARGET_AUDIENCE_ID_2 değerlerini, Hedef kitle kimliğini alma bölümünde aldığınız hedef kitlenin kimliğiyle değiştirin. Google Workspace kuruluşunuz için varsayılan Chat alanı paylaşım ayarlarını kullanmak istiyorsanız default ile değiştirin.

Geriye dönük uyumluluk için audience alanını kullanın.

Geriye dönük uyumluluk için, bir alana katılabilen tek bir hedef kitle belirtmek üzere audience alanını kullanmaya devam edebilirsiniz ancak bunun yerine hedef kitleleri ve ayrıntılı izinleri belirtmenizi öneririz.

audience alanını ayarlama işlemi, joinSpaceSetting alanında hedef kitleyi belirtme işlemiyle eşdeğerdir:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

TARGET_AUDIENCE_ID kısmını, Hedef kitle kimliğini alma bölümünde edindiğiniz hedef kitlenin kimliğiyle değiştirin. Google Workspace kuruluşunuz için varsayılan Chat alanı paylaşım ayarlarını kullanmak istiyorsanız default ile değiştirin.

API yanıtlarındaki erişim ayarlarını anlama

Alanları aldığınızda veya listelediğinizde yanıttaki AccessSettings nesnesi, alan için ayarlanan ayrıntılı izinleri yansıtır.

AccessSettings içindeki aşağıdaki alanlar, bir alanın aranabilirliğini ve katılma izinlerini gösterir:

  • accessState: Keşif izinlerinden türetilir (discoverSpaceSetting). Keşif, bir veya daha fazla hedef kitleye verilirse bu alan DISCOVERABLE olur. Aksi takdirde PRIVATE olur.
  • audience: Özellikle katılma izinleriyle eşlenir (joinSpaceSetting). Tek bir hedef kitleye katılma izni verildiyse bu alan, söz konusu hedef kitlenin kaynak adını içerir.

Katılan kitle olmayan herkese açık alan

Bir alan, hedef kitle tarafından bulunabilir ancak doğrudan katılım mümkün olmayabilir (örneğin, kullanıcıların katılmak için açıkça davet edilmesi gerekiyorsa).

Bu durumda, AccessSettings nesnesi aşağıdaki değerlere sahiptir:

  • accessState: DISCOVERABLE
  • audience: Atlandı veya null

accessState ayarı DISCOVERABLE olarak görünüyorsa ancak audience yoksa alanın discoverSpaceSetting içinde belirtilen hedef kitleler tarafından bulunabileceği ancak yalnızca davetle katılımın mümkün olduğu anlamına gelir. Alanı hangi hedef kitlelerin keşfedebileceğini görmek için accessPermissionSettings.discoverSpaceSetting alanını kontrol edin.

Hedef kitlelerle ilgili ayrıntılar için aşağıdaki kılavuzları inceleyin:

Chat API'yi kullanarak alan oluşturma veya güncelleme hakkında ayrıntılı bilgi için aşağıdaki kılavuzlara bakın: