בדף הזה נסביר איך ליצור חשבון 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 כדי להציג את המוצר הזה.