אחרי שיוצרים קבוצת מוצרים, אפשר ליצור מוצרים ולהוסיף אותם לקבוצת המוצרים. כשיוצרים מוצר, צריך לספק שם לתצוגה של המוצר וקטגוריית מוצרים. הקטגוריות הנתמכות כרגע הן:
homegoods-v2, apparel-v2,
toys-v2, packagedgoods-v1,
ו-general-v1
*.
אפשר גם לספק תיאור אופציונלי של המוצר ותוויות אופציונליות למוצר. תוויות הן צמדי מפתח/ערך שמתארים את המוצר, כמו color=black או style=mens. אפשר לכלול תוויות כדי לסנן את תוצאות החיפוש של מוצר מסוים, כך שיוצגו רק תמונות מסוימות של המוצר.
יצירת מוצר
אפשר להשתמש באפשרות 'ייבוא אונליין' כדי ליצור מוצר בודד. אחרי שיוצרים מוצר, אפשר להוסיף לו תמונה לדוגמה או להוסיף אותו לקבוצת מוצרים אחת או יותר.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION_ID: מזהה מיקום תקין. מזהי מיקום תקינים:
us-west1,us-east1,europe-west1ו-asia-east1. - DISPLAY_NAME: שם מוצג במחרוזת שאתם בוחרים.
- PRODUCT_DESCRIPTION: תיאור במחרוזת לפי בחירתכם.
- product-category: קטגוריית מוצר תקינה. קטגוריות המוצרים שזמינות כרגע הן:
homegoods-v2,apparel-v2,toys-v2,packagedgoods-v1ו-general-v1. -
productLabels: צמד מפתח/ערך אחד או יותר שמשויכים למוצר. לכל KEY_STRING צריך להיות VALUE_STRING משויך.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://vision.googleapis.com/v1/projects/project-id/locations/location-id/products
גוף בקשת JSON:
{
"displayName": "display-name",
"description": "product-description",
"productCategory": "product-category",
"productLabels": [
{
"key": "key-string",
"value": "value-string"
}
]
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-id" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/projects/project-id/locations/location-id/products"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/projects/project-id/locations/location-id/products" | Select-Object -Expand Content
גוף בקשה לדוגמה:
{
"displayName": "sample-product-1234",
"description": "Athletic shorts",
"productCategory": "apparel-v2",
"productLabels": [
{
"key": "style",
"value": "womens"
},
{
"key": "color",
"value": "blue"
}
]
}
אם הבקשה תתבצע בהצלחה, השרת יחזיר קוד סטטוס 200 OK של HTTP ואת התשובה בפורמט JSON.
הפלט שיוצג אמור להיות דומה לזה שמופיע בהמשך. אפשר להשתמש במזהה המוצר (37b9811d308c4e42 במקרה הזה) כדי לבצע פעולות אחרות על המוצר.
{
"name": "projects/project-id/locations/location-id/products/37b9811d308c4e42",
"displayName": "sample-product-456",
"description": "Athletic shorts",
"productCategory": "apparel-v2",
"productLabels": [
{
"key": "style",
"value": "womens"
},
{
"key": "color",
"value": "blue"
}
]
}
Go
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Go API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Java API.
כדי לבצע אימות ב-Google Product Search של Vision API, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
מידע על התקנת ספריית הלקוח של Vision API Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Node.js API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Python API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
שפות נוספות
C#: צריך לפעול לפי הוראות ההגדרה של C# בדף של ספריות הלקוח ואז לעבור אל מאמרי העזרה בנושא Google Product Search של Vision API ל- .NET.
PHP: עליכם לפעול לפי הוראות ההגדרה של PHP בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Product Search ל-PHP.
Ruby: צריך לפעול לפי ההוראות להגדרה של Ruby בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Google Product Search ל-Ruby.
הוספת מוצר לקבוצת מוצרים
אם יש לכם מוצר וקבוצת מוצרים, אתם יכולים להוסיף את המוצר לקבוצת המוצרים.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION_ID: מזהה מיקום תקין. מזהי מיקום תקינים:
us-west1,us-east1,europe-west1ו-asia-east1. - PRODUCT_SET_ID: המזהה של קבוצת המוצרים שרוצים להריץ עליה את הפעולה.
- PRODUCT_NAME: שם המשאב המלא של המוצר.
פורמט:
projects/PROJECT_ID/locations/LOCATION_ID/products/PRODUCT_ID
ה-method של ה-HTTP וכתובת ה-URL:
POST https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:addProduct
גוף בקשת JSON:
{
"product": "product-name"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-id" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:addProduct"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:addProduct" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{}
Go
מידע על התקנת ספריית הלקוח של Vision API Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Go API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Java API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
מידע על התקנת ספריית הלקוח של Vision API Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Node.js API.
כדי לבצע אימות ב-Google Product Search של Vision API, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
מידע על התקנת ספריית הלקוח של Vision API Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Python API.
כדי לבצע אימות ב-Google Product Search של Vision API, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
שפות נוספות
C#: צריך לפעול לפי הוראות ההגדרה של C# בדף של ספריות הלקוח ואז לעבור אל מסמכי העיון בנושא Vision API Product Search ל- .NET.
PHP: עליכם לפעול לפי הוראות ההגדרה של PHP בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Google Product Search ל-PHP.
Ruby: צריך לפעול לפי ההוראות להגדרה של Ruby בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Product Search ל-Ruby.
הסרת מוצר מקבוצת מוצרים
אפשר גם להסיר מוצר קיים מקבוצת מוצרים.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- LOCATION_ID: מזהה מיקום תקין. מזהי מיקום תקינים:
us-west1,us-east1,europe-west1ו-asia-east1. - PRODUCT_SET_ID: המזהה של קבוצת המוצרים שרוצים להריץ עליה את הפעולה.
- PRODUCT_NAME: שם המשאב המלא של המוצר.
פורמט:
projects/PROJECT_ID/locations/LOCATION_ID/products/PRODUCT_ID
ה-method של ה-HTTP וכתובת ה-URL:
POST https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:removeProduct
גוף בקשת JSON:
{
"product": "product-name"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-id" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:removeProduct"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/projects/project-id/locations/location-id/productSets/product-set-id:removeProduct" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{}
Go
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Go API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Java
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Java API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Node.js
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Node.js API.
כדי לבצע אימות ב-Vision API Product Search, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
Python
מידע על התקנת ספריית הלקוח של Vision API Google Product Search והשימוש בה מופיע במאמר ספריות הלקוח של Vision API Google Product Search. מידע נוסף מופיע במאמרי העזרה של Vision API Product Search Python API.
כדי לבצע אימות ב-Google Product Search של Vision API, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
שפות נוספות
C#: צריך לפעול לפי הוראות ההגדרה של C# בדף של ספריות הלקוח ואז לעבור אל מסמכי העיון בנושא Vision API Product Search ל- .NET.
PHP: עליכם לפעול לפי הוראות ההגדרה של PHP בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Product Search ל-PHP.
Ruby: צריך לפעול לפי ההוראות להגדרה של Ruby בדף של ספריות הלקוח ואז לעבור אל מסמכי העזר של Vision API Product Search ל-Ruby.