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 Chat alanlarını Google Workspace kuruluşundaki belirli kullanıcılarla nasıl paylaşacağınız açıklanmaktadır. Böylece bu kullanıcılar alanı keşfedip alana katılabilir.

Kuruluşunuzda bir alanı keşfedip alana katılabilecek 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. Alanın bilinirliğini ve paylaşılabilirliğini artırmak için bu kullanıcılarla Chat alanı paylaşabilirsiniz. Hedef kitleler, kullanıcıları tek tek davet etmek yerine 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 hâle 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 kitlelere gitme

  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ı güncelleyerek hedef kitle tarafından keşfedilebilir hâle getirebilirsiniz.

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 veya alana kimlerin katılabileceğ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 bu 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 belirleyin 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.

Aşağıdaki örnekte, bir alanın iki hedef kitle tarafından bulunabilmesini ve alana bu hedef kitlelerden yalnızca birinin katılabilmesini 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" } }
        ]
      }
    }
  }

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ılabilecek 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, hem joinSpaceSetting hem de discoverSpaceSetting alanları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, yanıttaki AccessSettings nesnesi, alan için ayarlanan ayrıntılı izinleri yansıtır.

AccessSettings bölümündeki 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 verildiyse 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ılma kitlesi 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 belirlenmişse 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: