Migrer depuis la version v2 alpha

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

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
La classification du type de produit.
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 version classique. 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.