Method: subscriptions.patch

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

Żądanie HTTP

PATCH https://workspaceevents.googleapis.com/v1/{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, które chcesz zaktualizować. Jeśli ominięte, zaktualizuje wszystkie pola uwzględnione w żądaniu.

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

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

Aby całkowicie zastąpić subskrypcję (co jest równoważne z użyciem wartości PUT), użyj wartości *. Wszystkie pominięte pola zostaną zaktualizowane pustymi wartościami.
validateOnly

boolean

Opcjonalnie: Jeśli ustawisz wartość true, usługa zweryfikuje i wyświetli podgląd żądania, ale nie zaktualizuje 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 protokołu 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/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.