Method: subscriptions.patch

Aktualizuje lub odnawia subskrypcję Google Workspace. Aby dowiedzieć się, jak korzystać z tej metody, przeczytaj artykuł Aktualizowanie lub odnawianie subskrypcji Google Workspace.

W przypadku subskrypcji zasobu docelowego Google Chat możesz zaktualizować subskrypcję w następujący sposób:

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
subscription.name

string

Identyfikator. Nazwa zasobu subskrypcji.

Format: subscriptions/{subscription}

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Opcjonalnie. Pole do zaktualizowania. Jeśli ten parametr zostanie pominięty, zaktualizowane zostaną wszystkie pola uwzględnione w żądaniu.

W przypadku subskrypcji możesz zaktualizować jedno z tych pól:

  • expireTime: sygnatura czasowa wygaśnięcia subskrypcji.
  • ttl: czas życia lub okres subskrypcji.
  • eventTypes: lista typów zdarzeń, które mają być otrzymywane w przypadku zasobu docelowego.

Jeśli użyjesz symbolu wieloznacznego * (odpowiednika symbolu PUT), pominięte pola zostaną ustawione na puste wartości i odrzucone, jeśli będą nieprawidłowe.
validateOnly

boolean

Opcjonalnie. Jeśli ma wartość true, weryfikuje i wyświetla podgląd żądania, ale nie aktualizuje subskrypcji.

Treść żądania

Treść żądania zawiera wystąpienie elementu Subscription.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

  • Pole metadata zawiera pustą tablicę.
  • Pole response zawiera zaktualizowane wystąpienie elementu Subscription.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • 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.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • 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

Więcej informacji znajdziesz w przewodniku po autoryzacji.