Method: subscriptions.patch

Met à jour ou renouvelle un abonnement Google Workspace. Pour savoir comment utiliser cette méthode, consultez Mettre à jour ou renouveler un abonnement Google Workspace.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
subscription.name

string

Identifiant. Nom de ressource de l'abonnement.

Format : subscriptions/{subscription}

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Facultatif. Champ à mettre à jour. Si elle est omise, tous les champs inclus dans la requête sont mis à jour.

Vous pouvez modifier l'un des champs suivants dans un abonnement :

  • expireTime : code temporel de l'expiration de l'abonnement.
  • ttl : durée de vie (TTL) ou durée de l'abonnement.
  • eventTypes : liste des types d'événements à recevoir concernant la ressource cible.

Pour remplacer complètement l'abonnement (l'équivalent de PUT), utilisez *. Tous les champs omis sont mis à jour avec des valeurs vides.
validateOnly

boolean

Facultatif. Si la valeur est définie sur true, la requête est validée et prévisualisée, mais l'abonnement n'est pas mis à jour.

Corps de la requête

Le corps de la requête contient une instance de Subscription.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

  • Le champ metadata contient un tableau vide.
  • Le champ response contient une instance mise à jour de Subscription.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide d'autorisation.