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 |
Erforderlich. Das Projekt und der Standort, an dem die Produkte gelöscht werden sollen. Das Format ist |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung | |
---|---|
{ "force": boolean, // Union field |
Felder | ||
---|---|---|
force |
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 |
Geben Sie an, welches ProductSet die zu löschenden Produkte enthält. |
|
deleteOrphanProducts |
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 |
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. |