Migrer depuis la version v2 alpha

Cette page est destinée aux clients qui utilisent actuellement la version v2 alpha de l'API Cloud Support et qui souhaitent migrer vers la version v2 bêta.

Premiers pas avec la version v2 bêta

Si vous utilisez déjà la version v2 alpha, vous n'avez pas besoin de configuration supplémentaire pour commencer à utiliser la version v2 bêta. Vous pouvez utiliser les mêmes comptes de service/identifiants. L'API sera déjà activée pour vous.

Pour appeler les points de terminaison bêta V2, il vous suffit de remplacer la partie /v2alpha/ de l'URL de la requête par /v2beta/. Par exemple, voici comment mettre à jour un appel cases.get de la version v2 alpha vers la version v2 bêta :

V2 Alpha : GET https://cloudsupport.googleapis.com/v2alpha/projects/123/cases/abc

V2 Bêta : GET https://cloudsupport.googleapis.com/v2beta/projects/123/cases/abc

Modifications destructives des classifications des demandes

Important : Il s'agit de la seule modification destructive entre la version V2 alpha et la version V2 bêta. Tous les points de terminaison non mentionnés dans cette section peuvent être migrés vers la version v2 bêta sans modifier la logique métier ni le format de requête/réponse.

Le seul comportement qui est passé de V2 alpha à V2 bêta est le type de classification de cas.

Classification des demandes V2 alpha

Champ	Obligatoire pour la création de la demande	Description
productType	Oui	string Type de produit auquel la classification correspond.
value	Oui	string Classification à utiliser lors de la création d'une demande, par exemple "Problème technique > Compute > Compute Engine"

Classification des demandes V2 bêta

Champ	Obligatoire pour la création de la demande	Description
id	Oui	string ID unique d'une classification. Doit être spécifié pour la création de la demande.
displayName	Non	string Nom à afficher de la classification.

Pourquoi avons-nous apporté ces modifications ?

• Supprimer le champ productType

  • Une première conception de l'API nous a nécessité d'ajouter ce champ, mais au fur et à mesure de son évolution, elle est devenue obsolète.
  • Ce champ est obligatoire, mais la seule valeur valide est GOOGLE_CLOUD. Cela ajoute un code standard à chaque demande de création de demande.

• Séparer value en id et displayName

  • Le champ value de la version v2 alpha doit être lisible (pour qu'un humain puisse choisir dans la liste des options) et lisible par l'ordinateur (afin que notre API puisse déterminer type de demande en cours de création).
  • La version v2 bêta sépare ces préoccupations en deux champs. id est la partie lisible par l'ordinateur de la classification, displayName est la partie lisible.
  • Nous avons ainsi la possibilité de modifier le nom à afficher sans interrompre les intégrations d'API. Par exemple, nous pouvons avoir plusieurs traductions de l'expression displayName ultérieurement, mais la valeur id restera la même pour toutes les traductions, car elles représentent la même classification de cas.