Method: subscriptions.patch

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

Untuk langganan di target resource 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

ID. Nama resource langganan.

Format: subscriptions/{subscription}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Opsional. Kolom yang akan diperbarui. Jika tidak disertakan, 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.

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

boolean

Opsional. Jika disetel ke true, permintaan akan divalidasi dan dipratinjau, 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.all.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.all.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.users.readstate.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.