Method: subscriptions.patch

Memperbarui atau memperpanjang langganan Google Workspace. Untuk mempelajari cara menggunakan metode ini, lihat Memperbarui atau memperpanjang langganan Google Workspace.

Permintaan HTTP

PATCH https://workspaceevents.googleapis.com/v1beta/{subscription.name=subscriptions/*}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
subscription.name

string

ID. Nama resource langganan.

Format: subscriptions/{subscription}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Opsional. Kolom yang akan diperbarui. Jika dihilangkan, akan memperbarui kolom apa pun yang disertakan dalam permintaan.

Anda dapat memperbarui salah satu kolom berikut dalam langganan:

  • expireTime: Stempel waktu saat langganan berakhir.
  • ttl: Time to live (TTL) atau durasi langganan.
  • eventTypes: Daftar jenis peristiwa yang akan diterima tentang resource target.

Untuk mengganti langganan sepenuhnya (setara dengan PUT), gunakan *. Setiap kolom yang dihapus akan diperbarui dengan nilai kosong.
validateOnly

boolean

Opsional. Jika ditetapkan ke true, permintaan akan divalidasi dan pratinjau permintaan, tetapi tidak akan memperbarui langganan.

Isi permintaan

Isi permintaan memuat instance Subscription.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

  • Kolom metadata berisi array kosong.
  • Kolom response berisi instance Subscription yang diupdate.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.