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

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

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

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

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

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

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

id [מזהה]	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
title	חולצת Google השחורה	ירוק טי של Google	Google Caps Cap
תיאור	חולצת 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
מותג	Google	Google	Google
קטגוריית מוצרים ב-Google	ביגוד אביזרים > בגדים	ביגוד אביזרים > בגדים	ביגוד אביזרים > אביזרי הלבשה > כובעים
color [צבע]	שחור	green	שחור
size	L	M	M
age_group	מבוגר	מבוגר	מבוגר
gender	זכר	זכר	יוניסקס
included_destination	Shopping Actions, מודעות שופינג	Shopping Actions, מודעות שופינג	Shopping Actions

products.insert

כדי להוסיף מוצר בודד, צריך להשתמש בכתובת ה-URL של הבקשה הבאה, ולציין את נתוני מספר חשבון Merchant וגוף 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 ואת 'product resource' ב גוף התגובה. הנה דוגמה לנתוני מוצרים שאוחזרו ממוצר עם מזהה 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 שחורה" באמצעות 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 עם בקשת ה-HTTP לדוגמה כתובת URL, מספר חשבון Merchant ומזהה המוצר (בפורמט של מזהה 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 למוצרים ב- משאבים מקש.

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

{
 "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"
   ]
  }
 ]
}