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

ספר: /product-review-feeds/_book.yaml

כותרת: הפניה לסכימת XML

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

מידע נוסף על סכימות XML זמין ב-XML של Schema XML.

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

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

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

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

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

רכיב חזרה סוג תיאור
<version> חובה (1) xs:string מציין באיזו גרסה של סכימת פיד המוצרים אתם משתמשים. בשלב זה, יש תמיכה רק <version>2.3</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> חובה (ללא הגבלה) reviewType ביקורת ייחודית על מוצר. אם ביקורת קשורה למספר מוצרים במלאי של בעל התוכן הדיגיטלי, יש לציין את הביקורת פעם אחת ולכלול מספר רכיבים מסוג <product> ברכיב <products>.

<review>

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

רכיב חזרה סוג תיאור
<review_id> אופציונלי (1) nonEmptyStringType המזהה הקבוע והייחודי של בדיקת המוצר במערכת של בעל התוכן הדיגיטלי.
<reviewer> חובה (1) reviewerType מחבר הביקורת על המוצר.
<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 תוכן הביקורת.
<pros> אופציונלי (1) xs:sequence מכיל את אנשי המקצוע על סמך חוות הדעת של כותב הביקורת. משמיטים טקסט סטנדרטי כמו "pro:" אלא אם הוא נכתב על ידי הבודק.
<cons> אופציונלי (1) xs:sequence מכיל את היתרונות והחסרונות של דעתו של כותב הביקורת. משמיטים טקסט סטנדרטי כמו "con:" אלא אם הוא נכתב על ידי הבודק.
<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> חובה (ללא הגבלה) nonEmptyStringType

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

דוגמה:

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

<cons>

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

רכיב חזרה סוג תיאור
<con> חובה (ללא הגבלה) nonEmptyStringType

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

דוגמה:

<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> חובה (ללא הגבלה) 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> חובה (ללא הגבלה) productType מוצר המשויך לביקורת.

<product>

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

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

<product_ids>

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

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

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

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

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

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

<gtins>

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

רכיב חזרה סוג תיאור
<gtin> חובה (ללא הגבלה) nonEmptyStringType מספר הפריט המסחרי הגלובלי של המוצר.

<mpns>

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

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

<skus>

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

רכיב חזרה סוג תיאור
<sku> חובה (ללא הגבלה) nonEmptyStringType יחידת שמירת המלאי של המוצר במלאי של בעל התוכן הדיגיטלי.

<brands>

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

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

<asins>

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

רכיב חזרה סוג תיאור
<asin> חובה (ללא הגבלה) nonEmptyStringType מספר הזיהוי הסטנדרטי של Amazon. כל ASIN הוא באורך 10 תווים ואלפאנומריים.