Bir alanı günceller. Örnek için Alan güncelleme başlıklı makaleye bakın.
displayName alanını güncellerken ALREADY_EXISTS hata mesajını alırsanız farklı bir görünen ad deneyin. Google Workspace kuruluşundaki mevcut bir alan bu görünen adı kullanıyor olabilir.
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.
Zorunlu. Güncellenen alan yolları (birden fazla varsa virgülle ayrılmış).
Bir alan 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ın güncellenmesini destekler. ALREADY_EXISTS hata mesajını alırsanız farklı bir değer deneyin. Google Workspace kuruluşundaki mevcut bir alan bu görünen adı kullanıyor olabilir.
spaceType: Yalnızca GROUP_CHAT alan türünü SPACE olarak değiştirmeyi destekler. Güncelleme maskesine displayName ile birlikte spaceType öğesini ekleyin ve belirtilen alanın boş olmayan bir görünen ada ve SPACE alan türüne sahip olduğundan emin olun. Görünen adı güncellerken belirtilen alana spaceType maskesini ve SPACE türünü eklemek, mevcut alanda zaten SPACE türü varsa 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ın geçmişini açarak veya kapatarak 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ğinizdeki diğer tüm alan maskelerini atlamanız gerekir. spaceHistoryState, useAdminAccess ile desteklenmez.
accessSettings.audience: spaceType alanının SPACE olduğu adlandırılmış alanda, alanı kimlerin keşfedebileceği, alana kimlerin katılabileceği ve mesajları kimlerin önizleyebileceğiyle ilgili erişim ayarını günceller. Mevcut alanda hedef kitle varsa bu alan maskesi için bir değer atlamadan kitleyi kaldırabilir ve alan erişimini kısıtlayabilirsiniz. Bir alanın erişim ayarlarını güncellemek için kimliği doğrulayan kullanıcının alan yöneticisi olması ve isteğinizdeki diğer tüm alan maskelerini atlaması gerekir. Alan içe aktarma modundaysa bu alanı güncelleyemezsiniz. Daha fazla bilgi edinmek için Belirli kullanıcıların alanları bulmasını sağlama başlıklı makaleyi inceleyin. accessSettings.audience, useAdminAccess ile desteklenmez.
permissionSettings: Alanın izin ayarlarını değiştirmeyi destekler. İzin ayarlarını güncellerken yalnızca permissionSettings alan maskelerini belirtebilirsiniz. Diğer alan maskelerini aynı anda 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ıdır. true olduğunda yöntem, kullanıcının Google Workspace yönetici ayrıcalıkları kullanılarak çalıştırılır.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-29 UTC."],[[["\u003cp\u003eUpdates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eSupports partial updates using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields to be modified.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for using administrator privileges with the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter, but some fields and functionalities are not supported in this mode.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP method and gRPC Transcoding syntax for the request URL.\u003c/p\u003e\n"]]],["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"],null,[]]
