Method: subscriptions.patch

aktualizuje lub odnawia subskrypcję Google Workspace; Aby dowiedzieć się, jak korzystać z tej metody, zobacz Aktualizowanie i 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

Opcjonalnie. Stałe. Identyfikator. Nazwa zasobu subskrypcji.

Format: subscriptions/{subscription}

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Opcjonalnie. Pole do aktualizacji. W przypadku jego pominięcia aktualizuje wszystkie pola uwzględnione w żądaniu.

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

  • expireTime: sygnatura czasowa wygaśnięcia subskrypcji.
  • ttl: czas życia danych (TTL) lub czas trwania subskrypcji.

Aby w pełni zastąpić subskrypcję (odpowiednik subskrypcji PUT), użyj *. Wszystkie pominięte pola zostaną uzupełnione o puste wartości.

validateOnly

boolean

Opcjonalnie. Jeśli ma wartość true, weryfikuje i wyświetla żądanie, 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 zaktualizowaną instancję 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/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.