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/v1/{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 disetel ke true, akan memvalidasi dan melihat pratinjau permintaan, tetapi tidak 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 diperbarui.

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.