Cómo migrar desde V2 Beta

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

Comenzar a usar V2

Si ya usas la versión beta 2, no es necesario que realices ninguna configuración adicional para comenzar a usarla. Puedes usar las mismas cuentas de servicio y credenciales. La API ya estará habilitada.

Para llamar a los extremos V2, solo reemplaza la parte /v2beta/ de la URL de la solicitud por /v2/. Por ejemplo, así es como se actualiza una llamada cases.get de la versión beta 2 a la versión 2:

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

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

Cambios rotundos en SearchCases, Case.severity y Comment.plainTextBody

Importante: Estos son los únicos cambios rotundos entre las versiones beta y 2. Los campos o extremos que no se mencionan en esta sección son exactamente iguales. Si actualmente no usas el extremo SearchCases, el campo Case.severity ni el campo Comment.plainTextBody, puedes migrar de forma segura a V2 sin ningún cambio en la lógica empresarial ni en el formato de respuesta de solicitud.

SearchCases cambios en los extremos

El extremo SearchCases cambió de las siguientes maneras:

• La ruta cambió de:

  GET https://cloudsupport.googleapis.com/v2/cases:search

  siguiente:

  GET https://cloudsupport.googleapis.com/v2beta/{parent=*/*}/cases:search

• El parámetro filter ya no acepta un filtro project o organization. En cambio, el proyecto o la organización de la URL se usará como el alcance de la búsqueda.

Cambios en los campos

Los campos cambiaron de las siguientes maneras:

• Se quitó el campo severity de cases y se reemplazó por el campo priority.

• Se quitó el campo plainTextBody de los comentarios de casos y se reemplazó por el campo body.

¿Por qué hicimos estos cambios?

• Cambia la ruta de acceso SearchCases

  • El método antiguo de definir el alcance de búsqueda era confuso y no coincidía con las prácticas de diseño estándar de la API de Google Cloud Platform.
  • La nueva forma hace que SearchCases sea más coherente con otros extremos de la API, como ListCases.

• Quita el campo Case.severity

  • La gravedad cumple el mismo propósito que la prioridad, por lo que quitarla simplifica la API.

• Quita el campo Comment.plainTextBody

  • Comment.body solo contiene texto sin formato, por lo que es un duplicado de este campo, por lo que quitaremos plainTextBody para simplificar la API.

Cómo adaptarse a los cambios

• Quita los filtros project y organization de las solicitudes SearchCase y decláralos en la URL de la solicitud.

• Usa el campo priority en los lugares en los que usaste el campo severity. Son muy similares en significado semántico, por lo que, generalmente, puedes intercambiar estas referencias.

• Usa el campo body en lugar del campo plainTextBody. Contenían la misma información. Por lo tanto, es probable que sea correcto reemplazar todas las referencias a plainTextBody por body.