Alan oluşturur. Import mode
'da adlandırılmış bir alan veya grup sohbeti oluşturmak için kullanılabilir. Örnek için Alan oluşturma başlıklı makaleyi inceleyin.
Aşağıdaki kimlik doğrulama türlerini destekler:
Yönetici onayı ve aşağıdaki yetkilendirme kapsamlarından biriyle uygulama kimlik doğrulaması:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.import
(yalnızca içe aktarma modundaki alanlar)
Uygulama olarak kimlik doğrulaması yapılırken istekte space.customer
alanı ayarlanmalıdır.
Uygulama olarak kimlik doğrulama yapıldığında Chat uygulaması, alanın üyesi olarak eklenir. Ancak insan kimlik doğrulamasının aksine, Chat uygulaması alan yöneticisi olarak eklenmez. Varsayılan olarak, Chat uygulaması tüm alan üyeleri tarafından alandan kaldırılabilir. Uygulamayı alandan yalnızca alan yöneticilerinin kaldırmasına izin vermek için space.permission_settings.manage_apps
seçeneğini managersAllowed
olarak ayarlayın.
Oluşturulduktan sonra alana üye olma durumu, alanın Import mode
içinde oluşturulup oluşturulmadığına bağlıdır:
- İçe aktarma modu: Üye oluşturulmaz.
- Diğer tüm modlar: Arayan kullanıcı üye olarak eklenir. Bu:
- Uygulama kimlik doğrulaması kullanılırken uygulamanın kendisi.
- Kullanıcı kimlik doğrulaması kullanılırken insan kullanıcı.
Alan oluştururken ALREADY_EXISTS
hata mesajını alırsanız farklı bir displayName
kullanmayı deneyin. Google Workspace kuruluşundaki mevcut bir alan bu görünen adı kullanıyor olabilir.
HTTP isteği
POST https://chat.googleapis.com/v1/spaces
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
requestId |
İsteğe bağlıdır. Bu isteğin benzersiz tanımlayıcısıdır. Rastgele bir UUID önerilir. Mevcut bir istek kimliğini belirtmek, yeni bir alan oluşturmak yerine bu kimlikle oluşturulan alanı döndürür. Farklı bir kimliği doğrulanmış kullanıcıyla aynı Chat uygulamasından mevcut bir istek kimliğini belirtmek hata döndürür. |
İstek içeriği
İstek metni, Space
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, Space
öğesinin yeni oluşturulmuş bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/chat.app.spaces.create
https://www.googleapis.com/auth/chat.app.spaces
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.