Method: spaces.setup

Bir alan oluşturur ve belirtilen kullanıcıları bu alana ekler. Arayan kullanıcı otomatik olarak alana eklenir ve istekte üyelik olarak belirtilmemelidir. Örnek için İlk üyeleri olan bir alan oluşturma başlıklı makaleyi inceleyin.

Eklenecek gerçek kullanıcıları belirtmek için uygun membership.member.name ile üyelikler ekleyin. Gerçek kullanıcı eklemek için users/{user} değerini kullanın. {user}, kullanıcının e-posta adresi olabilir. Aynı Workspace kuruluşundaki kullanıcılar için {user}, People API'deki kullanıcının id veya Directory API'deki kullanıcının id değeri olabilir. Örneğin, user@example.com için People API kişi profili kimliği 123456789 ise membership.member.name değerini users/user@example.com veya users/123456789 olarak ayarlayarak kullanıcıyı alana ekleyebilirsiniz.

Eklenecek Google gruplarını belirtmek için üyelikleri uygun membership.group_member.name ile ekleyin. Google grubu eklemek veya davet etmek için groups/{group} değerini kullanın. Burada {group}, Cloud Identity Groups API'deki grup için id değeridir. Örneğin, group@example.com grup e-postasının 123456789 kimliğini almak için Cloud Identity Groups arama API'sini kullanabilir, ardından membership.group_member.name öğesini groups/123456789 olarak ayarlayarak grubu alana ekleyebilirsiniz. Grup e-postaları desteklenmez ve Google grupları yalnızca adlandırılmış alanlarda üye olarak eklenebilir.

Adlandırılmış bir alanda veya grup sohbetinde, arayan kullanıcı bazı üyeleri engellerse ya da bazı üyeler tarafından engellenirse ya da bazı üyeleri ekleme izni yoksa bu üyeler oluşturulan alana eklenmez.

Arayan kullanıcı ile başka bir gerçek kullanıcı arasında doğrudan mesaj (DM) oluşturmak için gerçek kullanıcıyı temsil edecek tam olarak bir üyelik belirtin. Bir kullanıcı diğerini engellerse istek başarısız olur ve DM oluşturulmaz.

Arayan kullanıcı ile arama uygulaması arasında DM oluşturmak için Space.singleUserBotDm öğesini true olarak ayarlayın ve üyelik belirtmeyin. Bu yöntemi yalnızca arama uygulamasıyla bir DM ayarlamak için kullanabilirsiniz. Görüşme uygulamasını bir alanın üyesi olarak eklemek veya iki kullanıcı arasındaki mevcut bir DM'yi eklemek için Alana kullanıcı veya uygulama davet etme ya da ekleme başlıklı makaleyi inceleyin.

İki kullanıcı arasında zaten bir DM varsa, istek gönderilirken bir kullanıcı diğerini engellese bile mevcut DM döndürülür.

Mesaj dizisi halinde yanıtların olduğu alanlar desteklenmez. Alan oluştururken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName deneyin. Google Workspace kuruluşundaki mevcut bir alanda bu görünen ad zaten kullanılıyor olabilir.

Kullanıcı kimlik doğrulaması gerektirir.

HTTP isteği

POST https://chat.googleapis.com/v1/spaces:setup

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
Alanlar
space

object (Space)

Zorunlu. Space.spaceType alanının doldurulması zorunludur.

Alan oluşturmak için Space.spaceTypeSPACE olarak ayarlayın ve Space.displayName'yi ayarlayın. Alan oluştururken ALREADY_EXISTS hata mesajını alırsanız farklı bir displayName kullanmayı deneyin. Google Workspace kuruluşundaki mevcut bir alanda bu görünen ad zaten kullanılıyor olabilir.

Grup sohbeti oluşturmak için Space.spaceTypeGROUP_CHAT olarak ayarlayın. Space.displayName özelliğini ayarlamayın.

İnsanlar arasında 1:1 sohbet oluşturmak için Space.spaceType değerini DIRECT_MESSAGE, Space.singleUserBotDm değerini ise false olarak ayarlayın. Space.displayName veya Space.spaceDetails özelliğini ayarlamayın.

Gerçek kişi ile arayan Chat uygulaması arasında 1:1 görüşme oluşturmak için Space.spaceType değerini DIRECT_MESSAGE, Space.singleUserBotDm uygulamasını ise true olarak ayarlayın. Space.displayName veya Space.spaceDetails özelliğini ayarlamayın.

Halihazırda DIRECT_MESSAGE alanı varsa yeni alan oluşturulması yerine bu alan döndürülür.

requestId

string

İsteğe bağlı. Bu isteğin benzersiz bir tanımlayıcısı. Rastgele bir UUID önerilir. Mevcut bir istek kimliği belirtmek, yeni bir alan oluşturmak yerine bu kimlikle oluşturulan alanı döndürür. Kimliği doğrulanmış farklı bir kullanıcıyla aynı Chat uygulamasından gelen mevcut bir istek kimliğinin belirtilmesi hata döndürür.

memberships[]

object (Membership)

İsteğe bağlı. Alana katılmaya davet edilecek Google Chat kullanıcıları veya grupları. Arayan kullanıcıyı otomatik olarak eklendiği için dahil etmeyin.

Grup şu anda arayana ek olarak 20 üyeliğe kadar izin veriyor.

Gerçek kişi üyeliği için Membership.member alanı, name alanının doldurulduğu bir user içermelidir (biçim: users/{user}) ve type, User.Type.HUMAN olarak ayarlanmış olmalıdır. Yalnızca alan oluştururken gerçek kullanıcıları ekleyebilirsiniz (Chat uygulamalarının eklenmesi yalnızca arama uygulamasıyla doğrudan mesaj oluşturma için desteklenir). {user} için takma ad olarak kullanıcının e-posta adresini kullanarak da üye ekleyebilirsiniz. Örneğin, user.name users/example@gmail.com olabilir. Gmail kullanıcılarını veya harici Google Workspace alanlarındaki kullanıcıları davet etmek için {user} parametresinde kullanıcının e-postası kullanılmalıdır.

Google grubu üyeliği için Membership.group_member alanında, name değerinin doldurulduğu bir group bulunmalıdır (groups/{group} biçimi). Yalnızca Space.spaceType'i SPACE olarak ayarlarken Google grupları ekleyebilirsiniz.

Space.spaceType öğesi SPACE olarak ayarlandığında isteğe bağlıdır.

Space.spaceType, en az iki üyelikle birlikte GROUP_CHAT olarak ayarlanır.

Space.spaceType, tam olarak bir üyelikle birlikte gerçek bir kullanıcıyla DIRECT_MESSAGE olarak ayarlanır.

Gerçek kişi ile arayan Chat uygulaması arasında 1:1 görüşme oluştururken (Space.spaceType değeri DIRECT_MESSAGE, Space.singleUserBotDm değeri ise true olarak ayarlanır) boş olmalıdır.

Yanıt gövdesi

Başarılıysa yanıt metni, Space öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.