דף זה תורגם על ידי Cloud Translation API.

קריאות משאבים למוצרים

המשאב products מאפשר גמישות רבה ושליטה ביותר מ-60 מאפייני מוצרים.יש כמה שדות שחובה לכלול וצריך לכלול כדי לקבל אישור להצגה ב-Google שופינג. יש כמה שדות אופציונליים שעשויים להיות שדות חובה בהתאם לתנאים שונים, כמו מיקום, סוג המוצר, וריאציות של המוצר וחבילות מוצרים. מידע נוסף על יותר מ-60 פרמטרים אופציונליים שאפשר להגדיר למוצרים זמין במפרט נתוני המוצרים.

המשאב products מאפשר לכם insert, get, update וגם delete מוצר אחד בכל פעם, וגם list את כל המוצרים במסד הנתונים של Merchant Center.

בעזרת המשאב productstatuses אפשר לבדוק את סטטוס האישור או הדחייה של מוצר ספציפי ביעד מסוים. במדריך לסטטוסים מוסבר באילו מוצרים יכולות להיות בעיות באיכות הנתונים ואילו בעיות יכולות להיות.

בדוגמאות ל-API אנחנו משתמשים בשלושה מוצרים: שתי חולצות טישרט של Google ומכסה של Google. אנחנו משתמשים בקבוצה מינימלית של נתוני מוצרים שמופיעים בטבלה שלמטה כדי לבצע קריאות למשאבים של products כדי להוסיף, לקבל, לעדכן, להציג ולמחוק מוצרים בודדים ואצוות של מוצרים.

מומלץ להגדיר את פרטי המשלוח והמס ברמת החשבון ולא ברמת המוצר.

בחשבונות משנה שמוגדרים בהם כמה אתרי מכירה ב-Marketplaces, כל המוצרים צריכים לכלול את השדה external_seller_id. פרטים נוספים זמינים במאמר מזהי מוצרים.


id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
שם פריט	חולצת Google שחורה	חולצת Google ירוקה	כובע מצחייה של Google
תיאור	חולצת Google שחורה	טישרט של Google מ-100% כותנה	כובע קלאסי של Google
מזהה קבוצת פריטים	google_tee	google_tee
קישור	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
מצב	חדש	חדש	חדש
price	99.90 ILS	99.90 ILS	49.90 ILS
זמינות	במלאי	במלאי	במלאי
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin [מספר_פריט_מסחרי_גלובלי]	9504000059422	9504000059446	9504000059452
mpn [קוד_MPN]	00638NIC	00638ANG	00638ABC
brand	Google	Google	Google
קטגוריית מוצרים ב-Google	Apparel & Accessories > Clothing [ביגוד ואביזרים > ביגוד]	Apparel & Accessories > Clothing [ביגוד ואביזרים > ביגוד]	ביגוד ואביזרים > אביזרי הלבשה > כובעים
color [צבע]	שחור	green	שחור
size [מידה]	L	M	M
age_group	למבוגרים	למבוגרים	למבוגרים
gender	זכר	זכר	יוניסקס
included_destination	Shopping Actions, מודעות שופינג	Shopping Actions, מודעות שופינג	Shopping Actions

products.insert

כדי להוסיף מוצר יחיד, השתמשו בכתובת ה-URL של הבקשה הבאה, וציינו את מזהה המוכר שלכם וגוף JSON לדוגמה. הוספה יוצרת את המוצר החדש. אם קיימים ערכים למאפיינים channel, contentLanguage, offerId ו-feedLabel לגבי מוצר נתון, השיטה הזו מעדכנת את הרשומה ומחליפה את כל הנתונים מקריאות קודמות ל-API עבור המוצר הנתון.

מוצרים שמוחרגים מכל היעדים במשך יותר מ-7 ימים נמחקים אוטומטית.

בדוגמה המוצגת מוסיפים "חולצת Google שחורה" חדשה למוצרים הזמינים.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

קריאה לדוגמה לגוף הבקשה עבור products.insert:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

למוצר אפשר גם להגדיר מאפיינים מותאמים אישית בתוך גוף ה-JSON. לדוגמה, אפשר להגדיר purchase_quantity_limit למוצר בודד כדי להגביל את מספר הפריטים שהלקוח יכול להזמין:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

שימו לב שהמאפיין המותאם אישית purchase_quantity_limit מגדיר מגבלת רכישה לכל הזמנת לקוח להגדרת המוצר, ויש תמיכה גם בפידים. המאפיין זמין כרגע בגרסת בטא עד שנתמך באופן מלא ב-API. המוכרים יכולים להוסיף כל מאפיין מותאם אישית, אבל הוא לא גורם לעיבוד מסוים בממשקי ה-API.

קריאה מוצלחת מחזירה קוד HTTP 200 וגוף תגובה שמכיל את משאב המוצר שנוסף, כאשר רק id, offerId, contentLanguage, feedLabel ו-channel מאוכלסים:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

כדי לקבל מידע על מוצר ספציפי במסד הנתונים של Merchant Center, השתמשו בערך products.get. יכול להיות שיעברו כמה דקות עד שמוצר חדש שנוסף יהיה זמין בשיחה הזו.

משתמשים בכתובות ה-URL והפרמטרים הבאים של בקשת HTTP, במספר המוכר שלכם ובמזהה המוצר (בפורמט מזהה REST) של המוצר שרוצים לקבל:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

קריאה מוצלחת מחזירה את הערך HTTP 200 ואת 'משאב המוצר' בגוף התגובה. לפניכם נתוני מוצר לדוגמה שאוחזרו ממוצר עם המזהה online:en:US:1111111111:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

כדי לעדכן מוצר אחד, השתמשו בכתובת ה-URL הבאה של הבקשה באמצעות שיטת PATCH, וציינו את מזהה המוכר, מזהה המוצר וגוף JSON שמכיל את הנתונים שתרצו לעדכן לגבי המוצר. בניגוד ל-products.insert, שמחייב לספק את כל השדות הרלוונטיים, ב-products.update צריך לציין רק את השדות שרוצים לשנות.

כדי להוסיף או לשנות מאפיין, צריך לציין את השדה עם הערך החדש בגוף ה-JSON. בדוגמה המוצגת יתבצע עדכון של הערכים title ו-description של "Google טי-שירט שחור" קיים בנתוני המוצר שצוינו בגוף הבקשה, כך שכל שאר השדות יישארו ללא שינוי.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

קריאה לדוגמה לגוף הבקשה עבור products.update:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

ניתן לעדכן רק שדות ברמה העליונה באמצעות בקשת products.update. אם ברצונך לעדכן שדות מקוננים, עליך לספק את האובייקט כולו ברמה העליונה.

בדוגמה המוצגת נעדכן את האובייקט salePrice ברמה העליונה, כולל השדות המקוננים של מוצר קיים, עם נתוני המוצר שיסופקו בגוף הבקשה, כך שכל שאר השדות יישארו ללא שינוי.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

כדי לבחור שדות מסוימים לעדכון בלי לשנות שדות אחרים שמופיעים בגוף הבקשה, אפשר לציין updateMask. הפרמטר של מחרוזת השאילתה צריך להיות רשימה של שדות שמופרדים בפסיקים שרוצים לשנות. אפשר להשתמש ב-updateMask כשרוצים לטעון שרק השדות שיש להם שם יעודכנו. אם לא מציינים updateMask, זה המקביל לסימון כל השדות בבקשה לעדכון, כפי שמתואר בדוגמה שלמעלה.

בדוגמה המוצגת נעדכן רק את הערכים description ו-availability של 'חולצת Google שחורה' קיימת עם נתוני המוצר התואמים שצוינו בגוף הבקשה, כך שכל השדות האחרים, כולל השדה title, יישארו ללא שינוי.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

קריאה לדוגמה לגוף הבקשה עבור products.update:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

אם שדה מסוים מופיע ברשימה של updateMask אבל לא בגוף הבקשה, השדה יימחק מהמשאב Product אם הוא קיים.

בדוגמה שמוצגת נשתמש ב-updateMask כדי להסיר את הערך מהשדה salePrice.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

כדי למחוק אותו, גוף הבקשה לדוגמה לא יכול לכלול את השדה salePrice. אפשר גם לספק תוכן ללא גוף או גוף ריק. שאר השדות יישארו ללא שינוי, בתנאי שהם לא מופיעים ב-updateMask.

כדי להשתמש ב-updateMask בבקשת products.custombatch, צריך לציין את הערך updateMask בגוף הבקשה.

בדוגמה המוצגת נעדכן את הערכים price ו-availability של "Google Tee שחור" קיים בעזרת products.custombatch בנתוני המוצר שסופקו ברשומת הקבוצה, כך שכל השדות האחרים, כולל title ו-description, לא ישתנו.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

כדי למחוק מוצר בודד, משתמשים ב-products.delete עם דוגמה של כתובת ה-URL של בקשת ה-HTTP, מספר המוכר שלכם ומזהה המוצר (בפורמט של מזהה REST כמו online:en:US:1111111111) של המוצר שרוצים למחוק:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

תגובה מוצלחת מחזירה HTTP Status 204 ללא גוף תגובה.

products.list

ב-products.list מפורטים כל המוצרים שיש למוֹכרים במסד הנתונים של Merchant Center. צריך להשתמש בכתובת ה-URL הבאה של הבקשה:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

קריאה מוצלחת מחזירה נתוני HTTP 200 ו-JSON למוצרים במפתח "resources".

מוחזרים שלושת המוצרים הבאים לדוגמה:

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}

מזהי המוצרים

מצב אצווה