סימוכין לסכימת XML

סכימת ה-XML של פידים של ביקורות על מוצרים ב-Google מגדירה את המבנה הקביל של פיד ה-XML. סכימות XML משתמשות בסיומת הקובץ .xsd. בדומה לקובצי DTD, סכימת XML מגדירה את האלמנטים והמאפיינים שיכולים להופיע במסמך XML.

במדריך הזה בנושא סכימת XML אפשר לקבל מידע נוסף על סכימות XML.

סכימת ה-XML לפידים של ביקורות על מוצרים מפורסמת כאן: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

בהמשך מופיע תיאור של מבנה הפיד שמוגדר על ידי הסכימה הזו. בתיאור הזה, שמות הסוגים עם התחילית xs: מתייחסים לסוגים מובנים של סכימת XML שנמצאים במרחב השמות של XML‏ http://www.w3.org/2001/XMLSchema.

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

רכיב <feed> ברמה העליונה

הרכיב <feed> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<version> חובה (1) xs:string מציין את הגרסה של סכימת פיד ביקורות המוצרים שנעשה בה שימוש. בשלב הזה יש תמיכה רק ב-<version>2.4</version>.
<aggregator> אופציונלי (1) aggregatorType בעלי אתרים יכולים להשתמש באתר אגרגטור של ביקורות כדי לנהל ביקורות ולספק את הפידים. הרכיב הזה מציין שימוש באגרגטור ומכיל מידע על האגרגטור.
<publisher> חובה (1) publisherType המידע על בעל התוכן הדיגיטלי, שיכול להיות קמעונאי, יצרן, חברה שמספקת שירותי ביקורות או כל גורם שמפרסם ביקורות על מוצרים.
<reviews> אופציונלי (1) xs:sequence מכיל את הביקורות על המוצר.

המאפיין <feed> מגדיר אילוצים של ייחודיות לגבי רכיבים שמשמשים בפיד.

רכיבי צאצא

<aggregator>

בעלי אתרים יכולים להשתמש באתר אגרגטור של ביקורות כדי לנהל את הביקורות ולספק את הפידים. הרכיב הזה מציין את השימוש באגרגטור ומכיל מידע על האגרגטור. רכיב <aggregator> מכיל את הרכיבים הבאים בסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<name> חובה (1) nonEmptyStringType השם של האתר המרכז ביקורות על מוצרים.

<publisher>

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

רכיב מופע סוג תיאור
<name> חובה (1) nonEmptyStringType השם של המוציא לאור של הביקורות על המוצרים.
<favicon> אופציונלי (1) httpUrlType קישור לסמל המועדף של החברה של בעל התוכן הדיגיטלי. מידות התמונה צריכות להיות בגודל של סמל אתר: 16x16 פיקסלים. פורמט התמונה צריך להיות GIF, ‏ JPG או PNG.

<reviews>

מכיל את הביקורות על המוצר. הרכיב <reviews> מכיל את הרכיבים הבאים בסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<review> חובה (1-ללא הגבלה) reviewType ביקורת ייחודית על מוצר. אם ביקורת מתייחסת לכמה מוצרים במלאי של בעל התוכן הדיגיטלי, צריך לציין את הביקורת פעם אחת ולכלול כמה רכיבי <product> ברכיב <products>.

<review>

ביקורת ייחודית על מוצר. אם ביקורת מתייחסת לכמה מוצרים במלאי של בעל התוכן הדיגיטלי, צריך לציין את הביקורת פעם אחת ולכלול כמה רכיבי <product> ברכיב <products>.רכיב <review> מכיל את הרכיבים האלה בסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<review_id> חובה (1) nonEmptyStringType המזהה הייחודי הקבוע של הביקורת על המוצר במערכת של בעל התוכן הדיגיטלי.
<reviewer> חובה (1) reviewerType המחבר של הביקורת על המוצר.
<is_verified_purchase> אופציונלי (1) xs:boolean מציין אם אומת שהמשאיר/המשאירה של הביקורת רכש/ה את המוצר.
<is_incentivized_review> אופציונלי (1) xs:boolean המאפיין הזה מציין אם המבקר קיבל תמריץ לכתוב ביקורת על המוצר.
<review_timestamp> חובה (1) xs:dateTime

חותמת הזמן שמציינת מתי הביקורת נכתבה.

לדוגמה:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> אופציונלי (1) nonEmptyStringType הכותרת של הביקורת.
<content> חובה (1) nonEmptyStringType התוכן של הביקורת.
<review_language> אופציונלי (1) xs:string השפה של הביקורת (BCP 47).
<review_country> אופציונלי (1) xs:string קוד המדינה (ISO 3166-1) של כותב הביקורת.
<pros> אופציונלי (1) xs:sequence מכיל את היתרונות על סמך דעתו של כותב הביקורת. לא לכלול טקסט סטנדרטי (בוילרפלייט) כמו 'יתרונות:' אלא אם הוא נכתב על ידי כותב הביקורת.
<cons> אופציונלי (1) xs:sequence מכיל את החסרונות על סמך דעתו של כותב הביקורת. לא כוללים טקסט סטנדרטי כמו 'יתרונות:' אלא אם הוא נכתב על ידי כותב הביקורת.
<reviewer_images> אופציונלי (1) xs:sequence המאפיין מכיל קישורים לתמונות של המוצר שסופקו על ידי כותב הביקורת.
<review_url> חובה (1) reviewUrlType כתובת ה-URL של דף הנחיתה של הביקורת.
<ratings> חובה (1) xs:sequence מכיל את הדירוגים שמשויכים לביקורת.
<products> חובה (1) xs:sequence מכיל את המוצרים שמשויכים לביקורת.
<is_spam> אופציונלי (1) xs:boolean מציין אם הביקורת סומנה כספאם במערכת של בעל התוכן הדיגיטלי.
<collection_method> אופציונלי (1) collectionMethodType

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

unsolicited
המשתמש לא הגיב לבקשה ספציפית כששלח את הביקורת.
post_fulfillment
המשתמש שלח את הביקורת בתגובה לבקשה אחרי שההזמנה שלו סופקה.
<transaction_id> אופציונלי (1) nonEmptyStringType מזהה ייחודי קבוע של העסקה שמשויכת לביקורת במערכת של המוציא לאור. אפשר להשתמש במזהה הזה כדי לציין שכמה ביקורות משויכות לאותה עסקה.

<reviewer>

המחבר של הביקורת על המוצר. הרכיב <reviewer> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<name> חובה (1) reviewerNameType

השם של כותב הביקורת.

דוגמה:

<name>Jane</name>
<reviewer_id> אופציונלי (1) nonEmptyStringType

מזהה ייחודי קבוע של מחבר הביקורת במערכת של בעל האתר.

דוגמה:

<reviewer_id>14295</reviewer_id>

<name>

השם של כותב הביקורת. הרכיב <name> הוא הרחבה של nonEmptyStringType ומכיל את השם או הכינוי של כותב הביקורת. הרכיב <name> מכיל את המאפיינים האלה.

מאפיין מופע סוג תיאור
is_anonymous אופציונלי xs:boolean

מציין אם כותב הביקורת הוא אנונימי.

דוגמה:

<name is_anonymous="true">Anonymous</name>

<pros>

מכיל את היתרונות על סמך דעתו של כותב הביקורת. הרכיב <pros> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<pro> חובה (1-ללא הגבלה) nonEmptyStringType

יתרון ספציפי שמבוסס על דעת המבקר. היתרונות צריכים להופיע באותו סדר שבו הם מוצגים. לא לכלול טקסט סטנדרטי (בוילרפלייט) כמו 'יתרון:', אלא אם הוא נכתב על ידי כותב הביקורת.

דוגמה:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

מכיל את החסרונות על סמך דעתו של כותב הביקורת. הרכיב <cons> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<con> חובה (1-ללא הגבלה) nonEmptyStringType

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

דוגמה:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

כתובת ה-URL של דף הנחיתה של הביקורת. הרכיב <review_url> הוא הרחבה של httpUrlType והוא כולל את הקישור אל דף הנחיתה של הביקורת. רכיב <review_url> מכיל את המאפיינים האלה.

מאפיין מופע סוג תיאור
type חובה xs:string

הסוג חייב להיות אחד מהערכים הבאים:

singleton
דף הביקורת מכיל רק את הביקורת הזו.
group
דף הביקורת מכיל קבוצה של ביקורות, כולל הביקורת הזו.

דוגמה:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

הביקורת מכילה תמונות של המוצר שסופקו על ידי כותב הביקורת. התג <reviewer_images> מכיל הרבה רכיבי <reviewer_image>.

רכיב מופע סוג תיאור
<reviewer_image> חובה (1-ללא הגבלה) reviewImageType

תמונה של המוצר שעליו נכתבה הביקורת, שנוצרה על ידי כותב הביקורת.

<reviewer_image>

רכיב תמונה של ביקורת בודדת.

רכיב מופע סוג תיאור
<url> חובה (1) httpUrlType

כתובת URL של תמונה של המוצר שעליו נכתבה הביקורת, שנוצרה על ידי מחבר הביקורת. כתובת ה-URL לא חייבת להסתיים בסיומת של קובץ תמונה.

דוגמה:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

מכיל את הדירוגים שמשויכים לביקורת. הרכיב <ratings> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<overall> חובה (1) ratingType הדירוג הכולל של המוצר שניתן על ידי כותב הביקורת.

<overall>

הדירוג הכולל של המוצר שניתן על ידי כותב הביקורת. הרכיב <overall> הוא הרחבה של xs:decimal simpleType ומכיל את הדירוג שניתן על ידי כותב הביקורת. הערך צריך להיות בטווח שמוגדר על ידי המאפיינים min ו-max, כולל. רכיב <overall> מכיל את המאפיינים האלה.

מאפיין מופע סוג תיאור
min חובה xs:integer המספר המינימלי האפשרי לדירוג. זה צריך להיות הדירוג הכי נמוך שאפשר לקבל, ולא ערך שמציין שאין דירוג.
max חובה xs:integer המספר המקסימלי האפשרי לדירוג. הערך של מאפיין max צריך להיות גדול מהערך של מאפיין min.

<products>

מכיל את המוצרים שמשויכים לביקורת. הרכיב <products> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<product> חובה (1-ללא הגבלה) productType מוצר שמשויך לביקורת.

<product>

מוצר שמשויך לביקורת. הרכיב <product> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<product_ids> אופציונלי (1) productIdsType המזהים שמשויכים למוצר.
<product_name> אופציונלי (1) nonEmptyStringType שם תיאורי של מוצר.
<product_url> חובה (1) httpUrlType כתובת ה-URL של המוצר. אם כתובת ה-URL של הביקורת זהה לכתובת ה-URL של המוצר, הערך של כתובת ה-URL הזו יכול להיות זהה לערך של הרכיב <review_url>.

<product_ids>

המזהים שמשויכים למוצר. הרכיב <product_ids> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<gtins> חובה (לכל הביקורות שמשויכות למוצרים עם מספר GTIN ידוע)

אופציונלי לכל שאר הביקורות (1)		 gtinsType המאפיין מכיל מספרי GTIN (מספרי פריטים מסחריים גלובליים) שמשויכים למוצר. מערכת Google תומכת בסוגי משנה של מספרי GTIN (למשל, UPC,‏ EAN,‏ ISBN,‏ JAN).
<mpns> חובה (לכל הביקורות שמשויכות למוצרים עם קוד MPN ידוע)

אופציונלי לכל שאר הביקורות (1)		 mpnsType כולל קודי MPN (מספרי חלקים של היצרן) שמשויכים למוצר.
<skus> חובה (לכל הביקורות שמשויכות למוצרים עם מק"ט ידוע)

אופציונלי לכל שאר הביקורות (1)		 skusType מכילה מק"טים (מספרים קטלוגיים) שמשויכים למוצר. לרוב, הערך הזה זהה למזהה המוצר (Offer Id) בפיד המוצרים.
<brands> חובה (לכל הביקורות שמשויכות למוצרים עם מותג ידוע)

אופציונלי לכל שאר הביקורות (1)		 brandsType מכיל שמות מותגים שמשויכים למוצר.
<asins> אופציונלי (1) asinsType מכיל מספרי ASIN (מספרי זיהוי סטנדרטיים של אמזון) שמשויכים למוצר.

<gtins>

המאפיין מכיל מספרי GTIN (מספרי פריטים מסחריים גלובליים) שמשויכים למוצר. הרכיב <gtins> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<gtin> חובה (1-ללא הגבלה) nonEmptyStringType מספר הפריט המסחרי הגלובלי של המוצר. מערכת Google תומכת בסוגי משנה של מספרי GTIN (למשל, UPC,‏ EAN,‏ ISBN,‏ JAN).

<mpns>

כולל קודי MPN (מספרי חלקים של היצרן) שמשויכים למוצר. הרכיב <mpns> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<mpn> חובה (1-ללא הגבלה) nonEmptyStringType מספר החלק שהוקצה למוצר על ידי היצרן.

<skus>

מכילה מק"טים (מספרים קטלוגיים) שמשויכים למוצר. הרכיב <skus> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<sku> חובה (1-ללא הגבלה) nonEmptyStringType יחידת אחסון במלאי (SKU) של המוצר במלאי של המו"ל.

<brands>

מכיל שמות מותגים שמשויכים למוצר. הרכיב <brands> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<brand> חובה (1-ללא הגבלה) nonEmptyStringType שם המותג של המוצר.

<asins>

המאפיין מכיל מספרי ASIN (מספרי זיהוי סטנדרטיים של אמזון) שמשויכים למוצר. הרכיב <asins> מכיל את הרכיבים הבאים לפי הסדר שמופיע ברשימה.

רכיב מופע סוג תיאור
<asin> חובה (1-ללא הגבלה) nonEmptyStringType מספר הזיהוי התקני של אמזון (ASIN) של המוצר. כל ASIN הוא באורך 10 תווים והוא אלפאנומרי.