REST Resource: users.sections

Kaynak: Bölüm

Google Chat'teki bir bölümü temsil eder. Bölümler, kullanıcıların alanlarını düzenlemesine yardımcı olur. İki tür bölüm vardır:

  1. Sistem Bölümleri: Bunlar, Google Chat tarafından yönetilen önceden tanımlanmış bölümlerdir. Kaynak adları sabittir ve oluşturulamaz, silinemez veya displayName değiştirilemez. Örnekler:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps
  2. Özel Bölümler: Kullanıcı tarafından oluşturulan ve yönetilen bölümlerdir. sections.create kullanarak özel bir bölüm oluşturmak için displayName gerekir. Özel bölümler sections.patch kullanılarak güncellenebilir ve sections.delete kullanılarak silinebilir.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Alanlar
name

string

Tanımlayıcı. Bölümün kaynak adı.

Sistem bölümleri için bölüm kimliği sabit bir dizedir:

  • DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages
  • DEFAULT_SPACES: users/{user}/sections/default-spaces
  • DEFAULT_APPS: users/{user}/sections/default-apps

Biçim: users/{user}/sections/{section}

displayName

string

Zorunlu. Bölümün görünen adı. Yalnızca CUSTOM_SECTION türündeki bölümler için doldurulur. En fazla 80 karakteri destekler. CUSTOM_SECTION oluştururken gereklidir.

sortOrder

integer

Yalnızca çıkış. Bölümün diğer bölümlere göre sırası. Daha düşük sortOrder değerine sahip bölümler, daha yüksek değere sahip bölümlerden önce görünür.

type

enum (SectionType)

Zorunlu. Bölümün türü.

SectionType

Bölüm türleri.

Sıralamalar
SECTION_TYPE_UNSPECIFIED Belirtilmemiş bölüm türü.
CUSTOM_SECTION Özel bölüm.
DEFAULT_DIRECT_MESSAGES İki insan kullanıcı arasındaki DIRECT_MESSAGE veya herhangi bir özel bölüme ait olmayan GROUP_CHAT alanlarını içeren varsayılan bölüm.
DEFAULT_SPACES Herhangi bir özel bölüme ait olmayan varsayılan alanlar.
DEFAULT_APPS Kullanıcının yüklü uygulamalarını içeren varsayılan bölüm.

Yöntemler

create

Google Chat'te bölüm oluşturur.

delete

CUSTOM_SECTION türündeki bir bölümü siler.

list

Chat kullanıcısının erişebileceği bölümleri listeler.

patch

Bir bölümü günceller.

position

Bir bölümün sıralama ölçütünü değiştirir.