Method: projects.locations.products.purge

Asynchrone API zum Löschen aller Produkte in einem ProductSet oder aller Produkte, die nicht in einem ProductSet vorhanden sind.

Wenn ein Produkt zusätzlich zu anderen ProductSets zum angegebenen ProductSet gehört, wird das Produkt dennoch gelöscht.

Es wird empfohlen, das angegebene ProductSet erst zu löschen, wenn dieser Vorgang abgeschlossen ist. Es wird außerdem empfohlen, während eines laufenden Vorgangs keine Produkte aus dem Batch-Löschvorgang einem neuen ProductSet hinzuzufügen, da diese Produkte möglicherweise dennoch gelöscht werden.

Der Vorgang „products.purge“ kann nicht rückgängig gemacht werden. Daher wird empfohlen, die CSV-Dateien, die in productSets.import verwendet wurden, vor dem Starten von products.purge zu verwenden, wenn Sie die Produktgruppe ursprünglich erstellt haben, falls Sie die Daten nach dem Löschen noch einmal importieren müssen.

Wenn Sie beabsichtigen, alle Produkte aus einem ProductSet dauerhaft zu löschen und dann das leere ProductSet wiederzuverwenden, um neue Produkte noch einmal in das leere ProductSet zu importieren, müssen Sie warten, bis der Vorgang products.purge für dieses ProductSet abgeschlossen ist.

Mit der google.longrunning.Operation API können Sie den Fortschritt und die Ergebnisse der Anfrage verfolgen. Operation.metadata enthält BatchOperationMetadata. (Fortschritt)

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Standort, an dem die Produkte gelöscht werden sollen.

Das Format ist projects/PROJECT_ID/locations/LOC_ID.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "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.
}
Felder
force

boolean

Der Standardwert ist „false“. Überschreiben Sie diesen Wert mit „true“, um den Löschvorgang tatsächlich auszuführen.

Union-Feld target. Zu löschende Produkte. Für target ist nur einer der folgenden Werte zulässig:
productSetPurgeConfig

object (ProductSetPurgeConfig)

Geben Sie an, welches ProductSet die zu löschenden Produkte enthält.

deleteOrphanProducts

boolean

Wenn „deleteOrphanProducts“ auf „true“ gesetzt ist, werden alle Produkte gelöscht, die nicht zu einem ProductSet gehören.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ProductSetPurgeConfig

Konfiguration, um zu steuern, welches ProductSet die zu löschenden Produkte enthält.

JSON-Darstellung
{
  "productSetId": string
}
Felder
productSetId

string

Das ProductSet, das die zu löschenden Produkte enthält. Wenn ein Produkt zusätzlich zu anderen ProductSets zu productSetId gehört, wird das Produkt dennoch gelöscht.