Method: projects.locations.products.purge

API asíncrona para eliminar todos los productos de un ProductSet o todos los productos que no estén en ningún ProductSet.

Si un producto pertenece al ProductSet especificado, además de a otros ProductSets, se eliminará igualmente.

Le recomendamos que no elimine el ProductSet especificado hasta que se haya completado esta operación. También se recomienda no añadir ninguno de los productos implicados en la eliminación por lotes a un nuevo ProductSet mientras se esté ejecutando esta operación, ya que es posible que esos productos se eliminen.

No se puede deshacer la operación products.purge. Por lo tanto, le recomendamos que conserve los archivos CSV que haya usado en productSets.import (si así es como creó originalmente el conjunto de productos) antes de iniciar products.purge, por si necesita volver a importar los datos después de eliminarlos.

Si tienes previsto eliminar todos los productos de un ProductSet y, a continuación, reutilizar el ProductSet vacío para volver a importar productos nuevos, debes esperar a que finalice la operación products.purge de ese ProductSet.

La API google.longrunning.Operation se puede usar para monitorizar el 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 utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. El proyecto y la ubicación en los que se deben eliminar los productos.

El formato es projects/PROJECT_ID/locations/LOC_ID.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan 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 false. Anula este valor y asigna el valor "true" para purgar el contenido.

Campo de unión target. Los productos que se van a eliminar. target solo puede ser una de las siguientes cosas:
productSetPurgeConfig

object (ProductSetPurgeConfig)

Especifica qué ProductSet contiene los productos que se van a eliminar.

deleteOrphanProducts

boolean

Si deleteOrphanProducts es true, se eliminarán todos los productos que no estén en ningún ProductSet.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

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

ProductSetPurgeConfig

Configuración para controlar qué ProductSet contiene los productos que se van a eliminar.

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

string

ProductSet que contiene los productos que se van a eliminar. Si un producto pertenece a productSetId además de a otros ProductSets, se eliminará igualmente.