אלה הסוגים השונים של מזהי המוצרים ב-Content API for Shopping:
- מזהה מבצע
offerId
הוא מחרוזת שהוקצתה למוצר על ידי מוכר. המזהה הזה מייצג מוצר ספציפי.offerId
הוא ייחודי לקבוצת המוצרים במסד הנתונים של Merchant Center, ובדרך כלל הוא מספר סידורי.offerId
יכול להיות מספר מק"ט פנימי שמוכר מקצה למוצר.- מזהה REST
- מזהה REST הוא המזהה הייחודי של מוצר שהוקצה על ידי Google.
- מזהה REST הוא
productId
לקריאות ל-API ל-REST. מזהי REST נצברים בפורמט
online:en:label:1111111111
. מזהה ה-REST מורכב מ-4 החלקים הבאים, מופרדים בנקודתיים:- ערוץ ("אונליין" או "מקומי")
- שפת תוכן (באמצעות הקצאה של שתי אותיות, לדוגמה
en
אוfr
) - תווית פיד (יכול להיות קוד של שתי אותיות למדינת היעד של הפיד, לדוגמה:
US
אוFR
) - מזהה מבצע
הנתונים האלה מקובצים בתור
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 תווים. תלוי רישיות. ניתן להשתמש בספרות ובתווים מיוחדים _, -, . ו-~. |