Method: spaces.create

Alan oluşturur. Import mode içinde 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ğrularken Chat uygulaması, alanın üyesi olarak eklenir. Ancak, kullanıcı kimlik doğrulamasının aksine Chat uygulaması alan yöneticisi olarak eklenmez. Varsayılan olarak, Chat uygulaması alandan tüm alan üyeleri tarafından 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

string

İsteğe bağlı. Bu isteğin benzersiz kimliği. Rastgele bir UUID önerilir. İstek kimliği belirtmek, isteği idempotent yapar. Bu da aynı istek kimliğine sahip birden fazla özdeş isteğin yalnızca tek bir alan oluşturmasına neden olur. Aynı istek kimliğine sahip sonraki istekler, istenen ayrıntılar mevcut durumdan farklı olsa bile mevcut alanı döndürür ve alanı güncellemez.

Bu alanı etkili bir şekilde kullanmak için:

  • Sonraki isteklerin aynı olduğundan ve orijinal istekteki kimlik doğrulama bilgilerinin kullanıldığından emin olun.
  • Belirtilen istek kimliğiyle daha önce bir alan oluşturulduysa istek, bu alanı döndürür. Döndürülen alanın tam olarak doldurulmayabileceğini unutmayın. API, isteğinizdeki alanı sistem tarafından atanan kaynak adıyla doldurulmuş şekilde yansıtır. Alanla ilgili en son meta verileri almak için spaces.get işlevini çağırın.
  • Mevcut bir istek kimliğinin farklı bir kimliği doğrulanmış kullanıcıyla yeniden kullanılması hataya neden olur.

İstek metni

İstek metni, Space öğesinin bir örneğini içerir.

Yanıt metni

Başarılı olursa yanıt metni, yeni oluşturulan bir Space ö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.