REST Resource: users.sections

Resource: Bagian

Merepresentasikan bagian di Google Chat. Bagian membantu pengguna mengatur ruang mereka. Ada dua jenis bagian:

  1. Bagian Sistem: Ini adalah bagian yang telah ditentukan sebelumnya dan dikelola oleh Google Chat. Nama resource-nya tetap, dan tidak dapat dibuat, dihapus, atau diubah displayName-nya. Contohnya mencakup:

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps

  2. Bagian Kustom: Bagian ini dibuat dan dikelola oleh pengguna. Membuat bagian kustom menggunakan sections.create memerlukan displayName. Bagian kustom dapat diperbarui menggunakan sections.patch dan dihapus menggunakan sections.delete.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Kolom
name

string

ID. Nama resource bagian.

Untuk bagian sistem, ID bagian adalah string konstanta:

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

Format: users/{user}/sections/{section}
displayName

string

Wajib. Nama tampilan bagian. Hanya diisi untuk bagian berjenis CUSTOM_SECTION. Mendukung hingga 80 karakter. Wajib diisi saat membuat CUSTOM_SECTION.
sortOrder

integer

Hanya output. Urutan bagian dalam kaitannya dengan bagian lain. Bagian dengan nilai sortOrder yang lebih rendah muncul sebelum bagian dengan nilai yang lebih tinggi.
type

enum (SectionType)

Wajib. Jenis bagian.

SectionType

Jenis bagian.

Enum
SECTION_TYPE_UNSPECIFIED Jenis bagian tidak ditentukan.
CUSTOM_SECTION Bagian kustom.
DEFAULT_DIRECT_MESSAGES Bagian default yang berisi DIRECT_MESSAGE antara dua pengguna manusia atau ruang GROUP_CHAT yang tidak termasuk dalam bagian kustom mana pun.
DEFAULT_SPACES Ruang default yang tidak termasuk dalam bagian kustom mana pun.
DEFAULT_APPS Bagian default yang berisi aplikasi terinstal milik pengguna.

Metode

create

 Membuat bagian di Google Chat.

delete

 Menghapus bagian jenis CUSTOM_SECTION.

list

 Mencantumkan bagian yang tersedia untuk pengguna Chat.

patch

 Memperbarui bagian.

position

 Mengubah urutan pengurutan bagian.