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ę jako:

Żą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 do zaktualizowania. Jeśli to pole zostanie pominięte, zostaną zaktualizowane wszystkie pola zawarte w żądaniu.

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

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

Gdy używasz symbolu wieloznacznego * (odpowiednika PUT), pominięte pola są ustawiane na puste wartości i odrzucane, jeśli są nieprawidłowe.
validateOnly

boolean

Opcjonalnie. Jeśli ustawisz wartość true, żądanie zostanie zweryfikowane i wyświetlone w wersji roboczej, ale subskrypcja nie zostanie zaktualizowana.

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.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

Więcej informacji znajdziesz w przewodniku po autoryzacji.