Migrar de V2 Alfa

Esta página está dirigida a los clientes que actualmente usan la versión Alfa V2 de la API de Cloud Support y desean migrar a V2 Beta.

Cómo comenzar a usar V2 Beta

Si ya usas la V2 Alfa, no es necesario que realices ninguna configuración adicional para comenzar a usar la V2 Beta. Puedes usar las mismas cuentas de servicio o credenciales, y la API ya estará habilitada.

Para llamar a los extremos de la versión Beta de la V2, solo reemplaza la parte /v2alpha/ de la URL de la solicitud por /v2beta/. Por ejemplo, a continuación se muestra cómo actualizar una llamada cases.get de V2 Alfa a V2 Beta:

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

V2 Beta: GET https://cloudsupport.googleapis.com/v2beta/projects/123/cases/abc

Cambios rotundos en las clasificaciones de casos

Importante: Este es el único cambio rotundo entre las versiones V2 alfa y V2 beta. Cualquier extremo que no se mencione en esta sección se puede migrar de forma segura a la versión 2 (beta) sin ningún cambio en la lógica empresarial ni en el formato de solicitud o respuesta.

El único comportamiento que cambió de V2 Alfa a V2 Beta es el tipo de Clasificación de casos.

Clasificación de caso V2 Alfa

Campo	Obligatorio para la creación de casos	Descripción
productType	Sí	string Es el tipo de producto al que corresponde la clasificación.
value	Sí	string La clasificación que se usará cuando se cree un caso, p.ej., “Problema técnico > Compute > Compute Engine”

Clasificación de casos de la versión beta V2

Campo	Obligatorio para la creación de casos	Descripción
id	Sí	string El ID único de una clasificación. Debe especificarse para la creación de casos.
displayName	No.	string El nombre visible de la clasificación.

¿Por qué hicimos estos cambios?

• Quita el campo productType

  • Un diseño inicial de la API requería que agreguemos este campo, pero se volvió obsoleto a medida que la API evolucionaba.
  • Este campo es obligatorio, pero el único valor válido es GOOGLE_CLOUD. Eso agrega código estándar a cada solicitud de creación de casos.

• Separa value en id y displayName

  • El campo value de la versión Alfa (V2) debe ser legible por humanos (para que una persona pueda elegir de la lista) y legible para máquinas (para que nuestra API sepa qué tipo de caso se está creando).
  • V2 Beta separa estas inquietudes en dos campos. id es la parte legible por máquina de la clasificación, y displayName es la parte legible por humanos.
  • Esto nos brinda la flexibilidad de realizar cambios en el nombre visible sin interrumpir las integraciones de la API. Por ejemplo, es posible que queramos tener varias traducciones del displayName en el futuro, pero id sería igual para todas las traducciones, ya que representan la misma clasificación de casos.