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 ein Mitglied des angegebenen ProductSet ist, 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 eines neuen ProductSets hinzuzufügen, da diese Produkte möglicherweise dennoch gelöscht werden.

Der Vorgang „products.purge“ kann nicht rückgängig gemacht werden. Aus diesem Grund 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 zu löschen und dann das leere ProductSet zu verwenden, um neue Produkte noch einmal in das leere ProductSet zu importieren, müssen Sie warten, bis dieser Vorgang 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

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

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, welche Produktgruppe die zu löschenden Produkte enthält.

deleteOrphanProducts

boolean

Wenn „deleteOrphanProducts“ auf „true“ gesetzt ist, werden alle Produkte gelöscht, die nicht zu einer Produktgruppe 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, welche Produktgruppe die zu löschenden Produkte enthält.

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

string

Die Produktgruppe, die die zu löschenden Produkte enthält. Wenn ein Produkt zusätzlich zu anderen Produktgruppen ein Mitglied von „productSetId“ ist, wird es dennoch gelöscht.