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, elle met à jour tous les champs inclus dans la requête.

Vous pouvez mettre à jour l'un des champs suivants d'un abonnement:

  • expireTime: code temporel d'expiration de l'abonnement
  • ttl: valeur TTL (Time To Live) 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 true, valide et prévisualise la requête, mais ne met pas à jour l'abonnement.

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.