Erstellt eine neue ReferenceImage-Ressource und gibt diese zurück.
Das Feld boundingPoly ist optional. Wenn boundingPoly nicht angegeben ist, versucht das System, interessante Regionen im Bild zu erkennen, die mit der productCategory im übergeordneten Produkt kompatibel sind. Ist er angegeben, wird die Erkennung IMMER übersprungen. Das System wandelt Polygone in nicht gedrehte Rechtecke um.
Beachten Sie, dass die Pipeline die Größe des Bilds ändert, wenn es zu groß ist, um es zu verarbeiten (über 50 MP).
Mögliche Fehler:
- Gibt INVALID_ARGUMENT zurück, wenn imageUri fehlt oder länger als 4.096 Zeichen ist.
- Gibt INVALID_ARGUMENT zurück, wenn das Produkt nicht vorhanden ist.
- Gibt INVALID_ARGUMENT zurück, wenn boundingPoly nicht angegeben ist und keine mit der productCategory des übergeordneten Produkts kompatible Elemente erkannt werden.
- Gibt INVALID_ARGUMENT zurück, wenn boundingPoly mehr als 10 Polygone enthält.
HTTP-Anfrage
POST https://vision.googleapis.com/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
parent |
Ressourcenname des Produkts, in dem das Referenzbild erstellt werden soll. Format ist |
Suchparameter
| Parameter | |
|---|---|
referenceImageId |
Eine vom Nutzer bereitgestellte Ressourcen-ID für das ReferenceImage, das hinzugefügt werden soll. Wenn festgelegt, versucht der Server, diesen Wert als Ressourcen-ID zu verwenden. Wenn sie bereits verwendet wird, wird ein Fehler mit dem Code ALREADY_EXISTS zurückgegeben. Darf höchstens 128 Zeichen enthalten Er darf das Zeichen |
Anfragetext
Der Anfragetext enthält eine Instanz von ReferenceImage.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von ReferenceImage.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-vision
Weitere Informationen finden Sie in der Authentifizierungsübersicht.