Method: spaces.patch
Alanları günceller. Örnek için Alan güncelleme bölümüne bakın.
displayName alanını güncellerken 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şunda mevcut bir alan bu görünen adı zaten kullanıyor olabilir.
spaceType: Yalnızca GROUP_CHAT alan türünün SPACE olarak değiştirilmesini destekler. Güncelleme maskesine spaceType ile birlikte displayName öğesini ekleyin ve belirtilen alanın boş olmayan bir görünen ada ve SPACE alan türüne sahip 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 yöntemlerle güncellemeye çalışmak geçersiz bağımsız değişken hatasına neden olur. 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 maskesi için bir değer atamadan kitleyi kaldırabilir ve alan erişimini kısıtlayabilirsiniz. Bir alanın erişim ayarlarını güncellemek için kimlik doğrulaması yapan kullanıcının alan yöneticisi olması ve isteğinizde diğer tüm alan maskelerini çıkarması gerekir. Alan içe aktarma modundaysa bu alanı güncelleyemezsiniz. Daha fazla bilgi edinmek için Alanları belirli kullanıcılar tarafından bulunabilir hale getirme başlıklı makaleyi inceleyin. accessSettings.audience, useAdminAccess ile desteklenmez.
permissionSettings: 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.manageMembersAndGroupspermissionSettings.modifySpaceDetailspermissionSettings.toggleHistorypermissionSettings.useAtMentionAllpermissionSettings.manageAppspermissionSettings.manageWebhookspermissionSettings.replyMessages
|
useAdminAccess |
boolean
İsteğe bağlı. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılı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ılı bilgi 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.spaceshttps://www.googleapis.com/auth/chat.admin.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaces
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-02-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-02-27 UTC."],[[["Updates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings."],["Requires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges."],["Supports partial updates using the `updateMask` query parameter to specify the fields to be modified."],["Provides options for using administrator privileges with the `useAdminAccess` query parameter, but some fields and functionalities are not supported in this mode."],["Uses the PATCH HTTP method and gRPC Transcoding syntax for the request URL."]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"]]
