Method: subscriptions.patch

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

Untuk langganan pada resource target Chat, Anda dapat memperbarui langganan sebagai:

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
subscription.name

string

Pengenal. Nama resource langganan.

Format: subscriptions/{subscription}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

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

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.

Saat menggunakan karakter pengganti * (setara dengan PUT), kolom yang dihilangkan akan ditetapkan ke nilai kosong dan ditolak jika tidak valid.
validateOnly

boolean

Opsional. Jika ditetapkan ke true, permintaan akan divalidasi dan pratinjaunya akan ditampilkan, tetapi langganan tidak akan diperbarui.

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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.