Method: projects.locations.products.purge

API asíncrona para borrar todos los Products de un ProductSet o todos los que no estén en uno.

Si un Product forma parte del ProductSet especificado, además de otros ProductSets, el Product igualmente se eliminará.

Se recomienda no borrar el ProductSet especificado hasta que se complete esta operación. También se recomienda no agregar ninguno de los Products involucrados en la eliminación por lotes a un nuevo ProductSet mientras esta operación se esté ejecutando, ya que esos Products podrían terminar borrados.

No se puede deshacer la operación products.purge. Por lo tanto, se recomienda conservar los archivos CSV que se usaron en productSets.import (si así es como creaste el conjunto de productos originalmente) antes de iniciar products.purge, en caso de que necesites volver a importar los datos después de la eliminación.

Si el plan consiste en borrar definitivamente todos los productos de un ProductSet y, luego, volver a usar el elemento ProductSet vacío para volver a importar productos nuevos en el ProductSet vacío, debes esperar hasta que la operación products.purge haya finalizado en ese ProductSet.

La API google.longrunning.Operation se puede usar para realizar un seguimiento del progreso y los resultados de la solicitud. Operation.metadata contiene BatchOperationMetadata (progreso)

Solicitud HTTP

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/products:purge

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El proyecto y la ubicación en la que se deben borrar los Products.

El formato es projects/PROJECT_ID/locations/LOC_ID.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "force": boolean,

  // Union field target can be only one of the following:
  "productSetPurgeConfig": {
    object (ProductSetPurgeConfig)
  },
  "deleteOrphanProducts": boolean
  // End of list of possible types for union field target.
}
Campos
force

boolean

El valor predeterminado es falso. Anula este valor como verdadero para realizar la eliminación definitiva.

Campo de unión target. Los Products que se borrarán. target puede ser solo uno de los siguientes:
productSetPurgeConfig

object (ProductSetPurgeConfig)

Especifica qué ProductSet contiene los Products que se borrarán.

deleteOrphanProducts

boolean

Si deleteOrphanProducts es verdadero, se borrarán todos los Products que no se encuentren en ningún ProductSet.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Para obtener más información, consulta Descripción general de la autenticación.

ProductSetPurgeConfig

Configuración para controlar qué ProductSet contiene los Products que se borrarán.

Representación JSON 
{
  "productSetId": string
}
Campos
productSetId

string

El ProductSet que contiene los Products que se borrarán. Si un Product forma parte de productSetId además de otros ProductSets, el Product igualmente se borrará.