Method: spaces.setup

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bir alan oluşturur ve bu alana kullanıcı ekler. Kullanıcılar doğrudan eklenemiyorsa katılmaları için davetiye gönderir. Mesaj dizili yanıtlara sahip alanlar ve davetli erişimine sahip alanlar desteklenmez.

Kullanıcı kimlik doğrulaması ve chat.spaces.create kapsamı 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 metni

İ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ı zorunludur.

Alan oluşturmak için Space.spaceType.SPACE ve Space.displayName özelliğini ayarlayın.

Grup sohbeti oluşturmak için Space.spaceType.GROUP_CHAT simgesini ayarlayın. Space.displayName değerini ayarlamayın.

Gerçek kişiler arasında 1:1 görüşme oluşturmak için Space.spaceType.DIRECT_MESSAGE ve Space.singleUserBotDm değerini false olarak belirleyin. Space.displayName ve Space.spaceDetails seçeneklerini ayarlama.

Gerçek kişiyle bir Chat uygulaması arasında 1:1 görüşme oluşturmak için Space.spaceType.DIRECT_MESSAGE ve Space.singleUserBotDm değerlerini true olarak ayarlayın. Space.displayName ve Space.spaceDetails seçeneklerini ayarlama.

requestId

string

İsteğe bağlı. Bu istek için benzersiz tanımlayıcı. Rastgele bir UUID önerilir. Bu istek yalnızca bir requestId sağlanmışsa veya DM zaten mevcutsa gerçekleştirilebilir. Aynı Chat uygulamasında, kimliği doğrulanmış farklı bir kullanıcıya sahip mevcut bir requestId değeri belirtilirse hata döndürülür.

memberships[]

object (Membership)

İsteğe bağlı. Alana katılmaları için davet edilen ilk alan adı kullanıcıları veya gruplardır.

Grup şu anda en fazla 20 üyeye izin vermektedir.

Membership.member alanı, name alanı dolu ve User.Type.HUMAN olan bir kullanıcı içermelidir. Diğer tüm alanlar yok sayılır.

En az bir üyeliğin yanı sıra Space.spaceType.SPACE için zorunludur.

En az iki üyelikle birlikte Space.spaceType.GROUP_CHAT için de gereklidir.

Gerçek kişi olan bir kullanıcının Space.spaceType.DIRECT_MESSAGE için tam olarak bir üyelik belirtilmesi gerekir.

Desteklenmez: Alan dışındaki kullanıcıları davet etme veya diğer Chat uygulamalarını ekleme.

Yanıt metni

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

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme Kılavuzu'na bakın.