Method: contactGroups.update

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Nama grup kontak yang diperbarui harus unik untuk grup kontak pengguna. Mencoba membuat grup dengan nama duplikat akan menampilkan error HTTP 409.

Permintaan mutasi untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.

Permintaan HTTP

PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
contactGroup.resourceName

string

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "contactGroup": {
    "resourceName": string,
    "etag": string,
    "metadata": {
      "updateTime": string,
      "deleted": boolean
    },
    "groupType": enum (GroupType),
    "name": string,
    "formattedName": string,
    "memberResourceNames": [
      string
    ],
    "memberCount": integer,
    "clientData": [
      {
        "key": string,
        "value": string
      }
    ]
  },
  "updateGroupFields": string,
  "readGroupFields": string
}
Kolom
contactGroup.etag

string

Tag entitas HTTP resource. Digunakan untuk validasi cache web.

contactGroup.metadata

object (ContactGroupMetadata)

Hanya output. Metadata tentang grup kontak.

contactGroup.groupType

enum (GroupType)

Hanya output. Jenis grup kontak.

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

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

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

contactGroup.memberCount

integer

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

contactGroup.clientData[]

object (GroupClientData)

Data klien grup.

updateGroupFields

string (FieldMask format)

Opsional. Mask kolom untuk membatasi kolom di grup yang diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Jika tidak ditetapkan atau ditetapkan ke kosong, nilai defaultnya adalah name. Kolom yang diperbarui akan diganti. Nilai yang valid adalah:

  • dataklien
  • name
readGroupFields

string (FieldMask format)

Opsional. Mask kolom untuk membatasi kolom mana di grup yang ditampilkan. Jika tidak ditetapkan atau ditetapkan ke kosong, nilai defaultnya adalah metadata, groupType, dan name. Kolom yang valid adalah:

  • dataklien
  • grupJenis
  • jumlah anggota
  • metadata
  • name

Isi respons

Jika berhasil, isi respons memuat instance ContactGroup.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/contacts

Untuk mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.