Method: spaces.patch

Alanları günceller. Örnek için Alan güncelleme başlıklı makaleyi inceleyin.

displayName alanını güncelliyor ve ALREADY_EXISTS hata mesajını alıyorsanız farklı bir görünen ad deneyin. Google Workspace kuruluşunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.

Aşağıdaki kimlik doğrulama türlerini destekler:

HTTP isteği

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

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

Yol parametreleri

Parametreler
space.name

string

Tanımlayıcı. Alanın kaynak adı.

Biçim: spaces/{space}

Burada {space}, alana sistem tarafından atanan kimliği temsil eder. Alan kimliğini spaces.list() yöntemini çağırarak veya alan URL'sinden alabilirsiniz. Örneğin, alan URL'si https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA ise alan kimliği AAAAAAAAA olur.

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Zorunlu. Birden fazla alan yolu varsa virgülle ayrılmış güncellenmiş alan yolları.

Alanlar için aşağıdaki alanları güncelleyebilirsiniz:

spaceDetails: Alanın açıklamasını günceller. En fazla 150 karakter desteklenir.

displayName: Yalnızca spaceType alanının SPACE olduğu alanların görünen adını güncellemeyi destekler. ALREADY_EXISTS hata mesajını alırsanız farklı bir değer deneyin. Google Workspace kuruluşundaki mevcut bir alanda bu görünen ad zaten kullanılıyor olabilir.

spaceType: Yalnızca GROUP_CHAT alan türünün SPACE olarak değiştirilmesini destekler. displayName öğesini güncelleme maskesine spaceType ile birlikte ekleyin ve belirtilen alanda görünen adın boş olmadığından ve alan türünün SPACE olduğundan emin olun. Mevcut alanda zaten SPACE türü varsa görünen adı güncellerken belirtilen alana spaceType maskesini ve SPACE türünü dahil etmek isteğe bağlıdır. Alan türünü başka yollarla güncellemeye çalıştığınızda geçersiz bağımsız değişken hatası oluştu. spaceType, useAdminAccess ile desteklenmez.

spaceHistoryState: Alan için geçmişi etkinleştirerek veya devre dışı bırakarak alan geçmişi ayarlarını günceller. Yalnızca Google Workspace kuruluşu için geçmiş ayarları etkinleştirilmişse desteklenir. Alan geçmişi durumunu güncellemek için isteğinizde diğer tüm alan maskelerini çıkarmanız gerekir. spaceHistoryState, useAdminAccess ile desteklenmez.

accessSettings.audience: spaceType alanının SPACE olduğu adlandırılmış alanda, alanı keşfedebilecek, alana katılabilecek ve mesajları önizleyebilecek kullanıcıların erişim ayarını günceller. Mevcut alanın hedef kitlesi varsa bu alan maskesine bir değer atlayarak kitleyi kaldırabilir ve alan erişimini kısıtlayabilirsiniz. Bir alanın erişim ayarlarını güncellemek için, kimlik doğrulamasını yapan kullanıcının alan yöneticisi olması ve isteğinizdeki diğer tüm alan maskelerini kullanmaması gerekir. Alan içe aktarma modunda ise bu alanı güncelleyemezsiniz. Daha fazla bilgi edinmek için Bir alanı belirli kullanıcılar tarafından bulunabilir hale getirme başlıklı makaleyi inceleyin. accessSettings.audience, useAdminAccess ile desteklenmiyor.

permissionSettings: Bir alanın izin ayarlarının değiştirilmesini destekler. İzin ayarlarını güncellerken yalnızca permissionSettings alan maskelerini belirtebilirsiniz. Aynı anda diğer alan maskelerini güncelleyemezsiniz. permissionSettings, useAdminAccess ile desteklenmez. Desteklenen alan maskeleri şunlardır:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıklarını kullanarak çalışır.

Arayan kullanıcı, Chat ve Alanlar görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces OAuth 2.0 kapsamını gerektirir.

Bazı FieldMask değerleri, yönetici erişimi kullanılarak desteklenmez. Ayrıntılar için updateMask açıklamasına bakın.

İstek içeriği

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

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.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.