Method: projects.locations.products.purge

HTTP-Anfrage
Pfadparameter
Anfragetext
- JSON-Darstellung
Antworttext
Autorisierungsbereiche
ProductSetPurgeConfig
- JSON-Darstellung

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, vor dem Starten von products.purge die CSV-Dateien, die in productSets.import verwendet wurden, beizubehalten (falls Sie die Produktgruppe ursprünglich so erstellt haben), für den Fall, dass 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

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`.

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

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`. }

{
  "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 endgültigen 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

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.

productSetId