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

Facultatif. Immuable. 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 cette valeur est omise, les champs inclus dans la requête sont mis à jour.

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

  • expireTime: code temporel de l'expiration de l'abonnement.
  • ttl: valeur TTL (Time To Live) ou durée de l'abonnement.

Pour remplacer complètement l'abonnement (l'équivalent de PUT), utilisez *. 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 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 relatif aux autorisations.