Method: projects.locations.products.referenceImages.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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/v1/{parent=projects/*/locations/*/products/*}/referenceImages
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Pflichtangabe. Ressourcenname des Produkts, in dem das Referenzbild erstellt werden soll. Format ist projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.
|
Suchparameter
| Parameter |
referenceImageId |
string
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 / nicht enthalten.
|
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-30 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-30 (UTC)."],[],[],null,["# Method: projects.locations.products.referenceImages.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nCreates and returns a new ReferenceImage resource.\n\nThe `boundingPoly` field is optional. If `boundingPoly` is not specified, the system will try to detect regions of interest in the image that are compatible with the productCategory on the parent product. If it is specified, detection is ALWAYS skipped. The system converts polygons into non-rotated rectangles.\n\nNote that the pipeline will resize the image if the image resolution is too large to process (above 50MP).\n\nPossible errors:\n\n- Returns INVALID_ARGUMENT if the imageUri is missing or longer than 4096 characters.\n- Returns INVALID_ARGUMENT if the product does not exist.\n- Returns INVALID_ARGUMENT if boundingPoly is not provided, and nothing compatible with the parent product's productCategory is detected.\n- Returns INVALID_ARGUMENT if boundingPoly contains more than 10 polygons.\n\n### HTTP request\n\n`POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*/products/*}/referenceImages`\n\nThe URL uses [gRPC Transcoding](https://github.com/googleapis/googleapis/blob/master/google/api/http.proto) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [ReferenceImage](/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages#ReferenceImage).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [ReferenceImage](/vision/product-search/docs/reference/rest/v1/projects.locations.products.referenceImages#ReferenceImage).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-vision`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
