בדף הזה נסביר איך יוצרים חשבון Merchant Center ומעלים מוצר לדוגמה באמצעות Merchant API.
לפני שמתחילים
מפעילים את Merchant API בפרויקט ב-Google Cloud.
יצירת חשבון
כדי להשתמש ב-Merchant API, צריך חשבון Merchant Center. במאמר תחילת העבודה עם Merchant Center מוסבר איך יוצרים חשבון Merchant Center.
איך מוצאים את מספר החשבון
אפשר לקבל את מזהה החשבון באמצעות השיטה accounts.list.
אפשר להשתמש ב-Google APIs Explorer כדי להריץ בקשות ל-Merchant API. ב-APIs Explorer נעשה שימוש ב-Google OAuth 2.0 לצורך אימות. לפני שמריצים את הבקשות, מוודאים שתיבת הסימון Google OAuth 2.0 מסומנת.
כדי לבצע אימות באמצעות OAuth 2.0, צריך להיכנס לחשבון Google ואז להיכנס ל-APIs Explorer. בנוסף, צריך לאפשר ל-API Explorer לנהל את כרטיסי המוצרים ואת החשבונות שלכם.
הבקשה הבאה מראה איך אפשר לאחזר את מזהה החשבון:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
אחרי שהבקשה מופעלת בהצלחה, מוצגת התגובה הבאה:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
מעתיקים את {ACCOUNT_ID} כי תצטרכו אותו כדי להריץ בקשות אחרות.
יצירת מקור נתונים ראשי של מוצרים
כדי להוסיף מוצר, צריך מקור נתונים ראשי של מוצרים. בבקשה הבאה מוסבר איך יוצרים מקור נתונים שאפשר להשתמש בו כדי להוסיף מוצר לחשבון:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
מחליפים את {ACCOUNT_ID} במזהה של חשבון Merchant Center שיצרתם.
לאחר הרצת הבקשה הזו, תוצג התגובה הבאה:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
מעתיקים את הערך של השדה name כי תצטרכו אותו כדי להוסיף מוצר.
ייתכן שיעברו כמה דקות עד שמקור הנתונים שיצרתם יהיה זמין להוספת מוצרים.
אפשר לראות את מקור הנתונים הזה בממשק המשתמש של Merchant Center. מידע נוסף זמין במאמר איך ניגשים לכרטיסייה 'מקורות נתונים'.
הוסף מוצר
כדי להוסיף מוצרים לדוגמה לחשבון, מריצים את הבקשה הבאה:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
מחליפים את {DATASOURCE_NAME} בערך שהעתקתם מקודם.
לאחר הרצת הבקשה הזו, תוצג התגובה הבאה:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
מזהה המוצר של המוצר החדש שנוצר הוא online~en~US~tshirt-123. אפשר להשתמש בשיטה accounts.products.get כדי לאחזר פרטים על המוצר הזה. אפשר גם להשתמש בממשק המשתמש של Merchant Center כדי להציג את המוצר הזה.