REST Resource: contactGroups

Resource: GrupKontak

Grup kontak.

Representasi JSON
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (ContactGroupMetadata)
  },
  "groupType": enum (GroupType),
  "name": string,
  "formattedName": string,
  "memberResourceNames": [
    string
  ],
  "memberCount": integer,
  "clientData": [
    {
      object (GroupClientData)
    }
  ]
}
Kolom
resourceName

string

Nama resource untuk grup kontak, yang ditetapkan oleh server. String ASCII, dalam bentuk contactGroups/{contactGroupId}.

etag

string

Tag entitas HTTP resource. Digunakan untuk validasi cache web.

metadata

object (ContactGroupMetadata)

Hanya output. Metadata tentang grup kontak.

groupType

enum (GroupType)

Hanya output. Jenis grup kontak.

name

string

Nama grup kontak yang ditetapkan oleh pemilik grup atau nama yang diberikan oleh sistem untuk grup sistem.

Untuk contactGroups.create atau contactGroups.update nama harus unik untuk grup kontak pengguna. Mencoba membuat grup dengan nama duplikat akan menampilkan error HTTP 409.

formattedName

string

Hanya output. Nama yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP Accept-Language untuk nama grup sistem. Nama grup yang ditetapkan oleh pemilik sama dengan nama.

memberResourceNames[]

string

Hanya output. Daftar nama resource narahubung yang merupakan anggota grup kontak. Kolom hanya diisi untuk permintaan GET dan hanya akan menampilkan anggota sebanyak maxMembers dalam permintaan get.

memberCount

integer

Hanya output. Jumlah total kontak dalam grup, terlepas dari jumlah anggota maksimum yang ditentukan dalam permintaan.

clientData[]

object (GroupClientData)

Data klien grup.

Metadata GrupKontak

Metadata tentang grup kontak.

Representasi JSON
{
  "updateTime": string,
  "deleted": boolean
}
Kolom
updateTime

string (Timestamp format)

Hanya output. Waktu grup terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

deleted

boolean

Hanya output. True jika resource grup kontak telah dihapus. Hanya diisi untuk permintaan contactGroups.list yang menyertakan token sinkronisasi.

JenisGrup

Jenis grup kontak.

Enumerasi
GROUP_TYPE_UNSPECIFIED Tidak ditentukan.
USER_CONTACT_GROUP Grup kontak buatan pengguna.
SYSTEM_CONTACT_GROUP Grup kontak yang ditetapkan sistem.

DataKlien Grup

Data klien arbitrer yang diisi oleh klien. Kunci dan nilai duplikat diizinkan.

Representasi JSON
{
  "key": string,
  "value": string
}
Kolom
key

string

Kunci yang ditentukan klien untuk data klien.

value

string

Klien menentukan nilai data klien.

Metode

batchGet

Dapatkan daftar grup kontak yang dimiliki oleh pengguna terautentikasi dengan menentukan daftar nama resource grup kontak.

create

Buat grup kontak baru yang dimiliki oleh pengguna terautentikasi.

delete

Hapus grup kontak yang ada milik pengguna terautentikasi dengan menentukan nama resource grup kontak.

get

Dapatkan grup kontak tertentu yang dimiliki oleh pengguna terautentikasi dengan menentukan nama resource grup kontak.

list

Cantumkan semua grup kontak yang dimiliki oleh pengguna terautentikasi.

update

Perbarui nama grup kontak yang ada yang dimiliki oleh pengguna terautentikasi.