Method: projects.locations.products.referenceImages.create

יוצרת ומחזירה משאב ReferenceImage חדש.

השדה boundingPoly הוא אופציונלי. אם לא מציינים את boundingPoly, המערכת תנסה לזהות באזורים שמעניינים בתמונה תכונות שתואמות ל-productCategory במוצר האב. אם מציינים את זה, המערכת תמיד מדלגת על הזיהוי. המערכת ממירה מצולעים למלבנים לא מסובבים.

שימו לב: אם הרזולוציה של התמונה גדולה מדי לעיבוד (מעל 50MP), הצינור יקטין את התמונה.

שגיאות אפשריות:

  • הפונקציה מחזירה INVALID_ARGUMENT אם ה-imageUri חסר או ארוך מ-4,096 תווים.
  • הפונקציה מחזירה INVALID_ARGUMENT אם המוצר לא קיים.
  • הפונקציה מחזירה INVALID_ARGUMENT אם לא צוין boundingPoly, ולא זוהה דבר שתואם ל-productCategory של מוצר האב.
  • הפונקציה מחזירה INVALID_ARGUMENT אם boundingPoly מכיל יותר מ-10 מצולעים.

בקשת HTTP

POST https://alpha-vision.googleapis.com/v1/{parent=projects/*/locations/*/products/*}/referenceImages

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

שם המשאב של המוצר שבו רוצים ליצור את תמונת הדוגמה.

הפורמט הוא projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

פרמטרים של שאילתה

פרמטרים
referenceImageId

string

מזהה משאב שסופק על ידי המשתמש עבור ReferenceImage שרוצים להוסיף. אם הערך מוגדר, השרת ינסה להשתמש בו כמזהה המשאב. אם הוא כבר בשימוש, מוחזרת שגיאה עם הקוד ALREADY_EXISTS. האורך המקסימלי הוא 128 תווים. היא לא יכולה להכיל את התו /.

גוף הבקשה

גוף הבקשה מכיל מופע של ReferenceImage.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של ReferenceImage.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

מידע נוסף מופיע במאמר סקירה כללית על אימות.

רוצה לנסות?