Method: projects.locations.products.patch

Änderungen an einer Produktressource vornehmen. Derzeit können nur die Felder displayName, description und labels aktualisiert werden.

Wenn Labels aktualisiert werden, wird die Änderung erst nach der nächsten Indexzeit in Abfragen berücksichtigt.

Mögliche Fehler:

  • Wenn das Produkt nicht existiert, wird NOT_FOUND ausgegeben.
  • Gibt INVALID_ARGUMENT zurück, wenn displayName in updateMask vorhanden ist, aber in der Anfrage fehlt oder länger als 4.096 Zeichen ist.
  • Gibt INVALID_ARGUMENT zurück, wenn die Beschreibung in updateMask vorhanden ist, aber länger als 4.096 Zeichen ist.
  • Gibt INVALID_ARGUMENT zurück, wenn productCategory in updateMask vorhanden ist.

HTTP-Anfrage

PATCH https://vision.googleapis.com/v1p4beta1/{product.name=projects/*/locations/*/products/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
product.name

string

Der Ressourcenname des Produkts.

Format ist: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Dieses Feld wird beim Erstellen eines Produkts ignoriert.

Suchparameter

Parameter
updateMask

string (FieldMask format)

Der FieldMask, der angibt, welche Felder aktualisiert werden sollen. Wenn „updateMask“ nicht angegeben ist, müssen alle änderbaren Felder aktualisiert werden. Gültige Maskenpfade sind productLabels, displayName und description.

Eine kommagetrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Anfragetext

Der Anfragetext enthält eine Instanz von Product.

Antworttext

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

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.