Migrar desde la versión Alfa 2

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

Comenzar a usar la versión Beta 2

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

Para llamar a los extremos Beta V2, solo debes reemplazar la parte /v2alpha/ de la URL de la solicitud por /v2beta/. Por ejemplo, aquí 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

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

Clasificación de casos Alfa V2

Campo Obligatorio para la creación de casos Descripción
productType string
Corresponde al tipo de producto al que corresponde la clásica.
value string
La clasificación que se usará en la creación de un caso, p.ej., “Problema técnico > Compute > Compute Engine”

Clasificación de casos Beta V2

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

¿Por qué hicimos estos cambios?

  • Quita el campo productType

    • Un diseño anticipado de la API nos obligó a agregar este campo, pero a medida que la API evolucionó, se volvió obsoleto.
    • Este campo es obligatorio, pero el único valor válido es GOOGLE_CLOUD. Esto agrega código estándar a cada solicitud de creación de casos.
  • Separa value en id y displayName

    • El campo value en la versión Alfa V2 debe ser legible (para que una persona pueda elegir de la lista de opciones) y ser legible para la máquina (a fin de que nuestra API pueda determinar qué se está creando el tipo de caso).
    • La versión beta de V2 separa estos problemas en dos campos. id es la parte de la clasificación legible por la máquina, displayName es la parte legible.
    • Esto nos brinda la flexibilidad de hacer cambios en el nombre visible sin interrumpir las integraciones de la API. Por ejemplo, es posible que desees tener varias traducciones de displayName en el futuro, pero que id se mantenga igual para todas las traducciones, ya que representan la misma clasificación de casos.