Method: spaces.patch

Bir alanı 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şundaki mevcut bir alanda bu görünen ad kullanılıyor olabilir.

Kullanıcı kimlik doğrulaması gerekir.

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

Alanın kaynak adı.

Biçim: spaces/{space}

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Zorunlu. Birden fazla varsa virgülle ayrılmış olarak güncellenen alan yolları.

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

  • spaceDetails

  • displayName: Yalnızca spaceType alanının SPACE olduğu alanlarda görünen adın güncellenmesini destekler. ALREADY_EXISTS hata mesajını alıyorsanız farklı bir değer deneyin. Google Workspace kuruluşundaki mevcut bir alanda bu görünen ad 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 alan zaten SPACE türüne sahipse görünen ad güncellenirken belirtilen alana spaceType maskesinin ve SPACE türünün dahil edilmesi 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, yönetici erişimiyle desteklenmiyor.

  • 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ı etkinse desteklenir. Alan geçmişi durumunu güncellemek için isteğinizde diğer tüm alan maskelerini atlamanız gerekir. spaceHistoryState, yönetici erişimiyle desteklenmiyor.

  • accessSettings.audience: Alanı kimlerin keşfedebileceğini, alana katılabileceğini ve spaceType alanının SPACE olduğu adlandırılmış alanda 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, yönetici erişimiyle desteklenmiyor.

  • Geliştirici Önizlemesi: Bir alanın izin ayarlarının değiştirilmesini destekler. Desteklenen alan yolları şunları içerir: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (Uyarı: diğer tüm izin olmayan ayarlar alan yollarıyla birlikte hariç). permissionSettings, yönetici erişimiyle desteklenmiyor.
useAdminAccess

boolean

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

Görüşmeyi yapan kullanıcı, sohbet ve alan görüşmelerini yönetme ayrıcalığına sahip bir Google Workspace yöneticisi olmalıdır.

chat.admin.spaces OAuth 2.0 kapsamı gerekir.

Bazı FieldMask değerleri, yönetici erişimi kullanılırken 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.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.