מזהי המוצרים

אלה הסוגים השונים של מזהי המוצרים ב-Content API for Shopping:

מזהה מבצע
offerId הוא מחרוזת שהוקצתה למוצר על ידי מוכר. המזהה הזה מייצג מוצר ספציפי.
offerId הוא ייחודי לקבוצת המוצרים במסד הנתונים של Merchant Center, ובדרך כלל הוא מספר סידורי.
offerId יכול להיות מספר מק"ט פנימי שמוכר מקצה למוצר.
מזהה REST
מזהה REST הוא המזהה הייחודי של מוצר שהוקצה על ידי Google.
מזהה REST הוא productId לקריאות ל-API ל-REST.

מזהי REST נצברים בפורמט online:en:label:1111111111. מזהה ה-REST מורכב מ-4 החלקים הבאים, מופרדים בנקודתיים:

  1. ערוץ ("אונליין" או "מקומי")
  2. שפת תוכן (באמצעות הקצאה של שתי אותיות, לדוגמה en או fr)
  3. תווית פיד (יכול להיות קוד של שתי אותיות למדינת היעד של הפיד, לדוגמה: US או FR)
  4. מזהה מבצע

הנתונים האלה מקובצים בתור channel:contentLanguage:feedLabel:offerId, לדוגמה, online:en:US:1111111111.

מזהה חיצוני של אתר מכירה (Marketplaces)

בזירות מסחר צריך להקצות external_seller_id למוצרים שהועלו לחשבון של בתי עסק מרובים. השדה הזה מייצג מוכר עצמאי.

הערכים ב-external_seller_id הם תלויי אותיות רישיות וצריכים לעמוד בקריטריונים הבאים:

  • אורך של 1-50 תווים
  • רק תווי ASCII אלפאנומריים וקווים תחתונים (_), מקף (-), נקודות (.) וטילדה (~)

השדה הזה לא זהה לשדה seller_id הפנימי.

בטבלה הבאה מופיע סיכום של כמה מהמזהים שאפשר לשייך למוצר:

מאפיין תיאור דוגמה הערות
offerId מזהה שמוקצה למוצר על ידי המוכר. 1111111111 סוג נתוני מחרוזת, מזהה ייחודי להצעה של מוצר.
מזהה REST מזהה ש-Google מקצה למוצר. בפורמט channel:contentLanguage:feedLabel:offerId. online:en:label:1111111111 מזהה מלא כולל offerId.
productId משמש לציון מזהה ה-REST בקריאות ל-API. online:en:label:1111111111 זהו מזהה REST של מוצר.
id אותו הערך כמו מזהה REST ו-productId. online:en:label:1111111111 משמש בתוך גוף ה-JSON של מוצר ל-productId.
external_seller_id מזהה של אתר מכירה שנבחר על ידי Marketplace. example-Seller1 נדרש בחשבונות מרובי אתרי מכירה. הסיסמה חייבת לכלול בין 1 ל-50 תווים. תלוי רישיות. ניתן להשתמש בספרות ובתווים מיוחדים _, -, . ו-~.