Method: spaces.patch

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.

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

  • Aşağıdaki yetkilendirme kapsamlarından biriyle kullanıcı kimlik doğrulaması:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (yalnızca içe aktarma modundaki alanlar)
    • Kullanıcı kimlik doğrulaması, bir yönetici hesabı kimlik doğruladığında, useAdminAccess true olduğunda ve aşağıdaki yetkilendirme kapsamları kullanıldığında yönetici ayrıcalıkları verir:
      • https://www.googleapis.com/auth/chat.admin.spaces

Uygulama kimlik doğrulamasıyla ilgili sınırlamalar:

  • space.predefined_permission_settings veya space.permission_settings değerini güncellemek için uygulamanın alan oluşturucu olması gerekir.
  • Uygulama kimlik doğrulaması için space.access_settings.audience güncelleme desteklenmez.

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 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. 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.

Arayan 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ı gerektirir.

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

İ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ılavuzu'na bakın.