סכימת XML

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

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

תיאור

רכיב המאגר העליון המכיל את כל הרכיבים האחרים בפיד.

מאפיינים

שם פורמט אירועים תיאור
xmlns xs:string חובה (1) יש לכתוב בתוך הקוד את הערך הבא:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string חובה (1) יש לכתוב בתוך הקוד את הערך הבא:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string חובה (1) יש לקבע בתוך הקוד את הערך הבא ולהשאיר רווח ריק אחד בין כתובות URL:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

דוגמה

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

מכיל

שם פורמט אירועים תיאור
merchants -- אופציונלי (0–1) רכיב קונטיינר לרכיבי <merchant>.
deleted_merchants -- אופציונלי (0–1) רכיב קונטיינר לרכיבי <deleted_merchant>.
reviews -- אופציונלי (0–1) רכיב קונטיינר לרכיבי <review>.
deleted_reviews -- אופציונלי (0–1) רכיב קונטיינר לרכיבי <deleted_review>.

<merchants>

תיאור

מאגר לרכיבי <merchant>.

מכיל

שם פורמט אירועים תיאור
merchant -- חובה (1–n) האלמנט חוזר לכל מוכר.

<merchant>

תיאור

כל רכיב <merchant> מכיל מידע וביקורות עבור מוכר אחד.

מאפיינים

שם פורמט אירועים תיאור
id מזהה חובה (1) הוא חייב להיות ייחודי ויציב בכל הפידים. במילים אחרות, אם פיד של היום ופיד מלפני 90 יום מתייחסים לאותו מוכר, המזהה שלו צריך להיות זהה.

דוגמה

<merchant id="2739">

מכיל

יש לכלול את הרכיבים הבאים ברכיב המוכר.

שם פורמט אירועים תיאור
name nonEmptyString חובה (1) שם תצוגה של המוכר שאפשר לקרוא.
merchant_url xs:anyURI חובה (1) כתובת האתר הראשי של המוכר.
אין להשתמש בכתובת URL להפניה אוטומטית לערך הזה. במילים אחרות, הערך צריך להפנות ישירות לאתר של המוכר.

דוגמה: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:anyURI חובה (1) כתובת ה-URL של דף הנחיתה שמארח את הביקורות על המוכר הזה.
אין להשתמש בכתובת URL להפניה אוטומטית.

דוגמה: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp DateTimeWithTimeZone חובה (1) השעה/התאריך שבהם המוכר נוצר. זה לא אמור להשתנות.
last_update_timestamp DateTimeWithTimeZone חובה (1) השעה/התאריך שבהם המוכר עודכן לאחרונה. אם אחד מהשדות ברכיב <merchant> מעודכן עבור מספר חשבון Merchant נתון, הערך הזה חייב להשתנות גם הוא.

<deleted_merchants>

תיאור

קונטיינר של מוכרים שנמחקו.

מכיל

שם פורמט אירועים תיאור
deleted_merchant -- חובה (1–n) מכיל רכיבים הקשורים למוכר שנמחק אחד.

<deleted_merchant>

תיאור

המוכר שנמחק.

מאפיינים

שם פורמט אירועים תיאור
id מזהה חובה (1) מציין את מזהה המוכר שיש למחוק מהפיד. המזהה צריך להתאים למאפיין id של רכיב <merchant> בכל קובץ פיד קודם.

מכיל

שם פורמט אירועים תיאור
last_update_timestamp DateTimeWithTimeZone חובה (1) השעה/התאריך שבהם מוכר הוסר מהמערכת.

דוגמה: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

דוגמה

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

תיאור

מאגר לרכיבי <review>.

מכיל

שם פורמט אירועים תיאור
review -- חובה (1–n) הרכיב מופיע בכל ביקורת.

<review>

תיאור

מאגר שמכיל פרטים שקשורים לביקורת.

מאפיינים

שם פורמט אירועים תיאור
id מזהה חובה (1) המזהה של ביקורת במערכת שלך. הוא חייב להיות ייחודי ויציב בכל הפידים.

דוגמה: 

<review id=132739 mid=1234>
mid מזהה חובה (1) המזהה של המוכר שעבורו מתבצעת הביקורת.

מכיל

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

שם פורמט אירועים תיאור
reviewer_name nonEmptyString אופציונלי (0–1) השם המוצג של מחבר הביקורת, בתנאי שהביקורת צריכה לכלול מחבר עם שם. ביקורות אנונימיות לא צריכות לכלול את השדה הזה.

דוגמה: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp DateTimeWithTimeZone חובה (1) התאריך והשעה שבהם נשלחה הביקורת על ידי המשתמש. זה לא אמור להשתנות.

דוגמה: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp DateTimeWithTimeZone חובה (1) השעה/התאריך של הרכיב ברכיב <review> השתנה לאחרונה. אם אחד מהשדות ברכיב <review> מעודכן עבור מזהה ביקורת נתון, גם הערך הזה חייב להשתנות.

דוגמה: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code קוד מדינה חובה (1) המדינה של כותב הביקורת. אם היא זמינה, זוהי המדינה שאליה נשלח המוצר או שבה השירות בוצע. אם לא, יש להשתמש במדינה שבה הכותב נמצא במהלך יצירת הביקורת. קוד המדינה צריך להיות בפורמט ISO 3166-1 alpha-2.

דוגמה: 

  <country_code>
    US
  </country_code>
title xs:string אופציונלי (0–1) הכותרת של הביקורת. הכותרת צריכה להיות טקסט פשוט ללא תגי HTML.

דוגמה: 

  <title>
    Great prices
  </title>
content xs:string חובה (1) תוכן הביקורת. הטקסט צריך להיות בצורה חופשיה שהמשתמש מספק, ואין לחתוך אותו. התוכן צריך להיות טקסט פשוט ללא תגי HTML. לדוגמה, מעבר שורה צריך להיות מיוצג על ידי תו של פיד שורה, ולא תג <br> אם מקבלים תשובות רבות לשאלות שונות, צריך לכלול את כל התשובות עם ההקשר המינימלי כדי שהתגובות יהיו הגיוניות. אין להוסיף הקשר אם נותרו שאלות שלא נענו.

דוגמה: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

דוגמה: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- חובה (1) רכיב מאגר של דירוגי המוֹכר. אם אין דירוג זמין עבור הרכיב <overall>, צריך להחריג את כל הביקורת המשויכת מהפיד כי הרכיב <overall> נדרש והביקורת לא תאושר בלעדיו.
collection_method CollectionMethodType חובה (1) השיטה ששימשה לאיסוף הביקורת. הערך חייב להיות אחד מאלה:
  • ללא אישור מצד המשתמש: כשהמשתמש שלח את הביקורת, הוא לא הגיב לבקשה ספציפית.
  • point_of_sale: המשתמש שלח את הביקורת בתגובה לשידול כאשר המשתמש ביצע הזמנה.
  • after_fulfillment: המשתמש שלח את הביקורת בתגובה לשידול לאחר מילוי הזמנה של המשתמש.

דוגמה: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

תיאור

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

מכיל

יש לכלול את הרכיבים הבאים ברכיב הדירוגים.

שם פורמט אירועים תיאור
overall טווח דירוגים חובה (1) הדירוג הכולל של הבודק למוכר.

דוגמה: 

  <overall min="1" max="10">9</overall>
customer_service טווח דירוגים אופציונלי (0–1) הדירוג של כותב הביקורת על איכות שירות הלקוחות של המוכר הזה.

דוגמה: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

תיאור

קונטיינר של ביקורות שנמחקו.

מכיל

שם פורמט אירועים תיאור
deleted_review -- חובה (1–n) מכיל רכיבים שקשורים לביקורת אחת שנמחקה.

<deleted_review>

תיאור

בודקים אילו ההגדרות נמחקו.

מאפיינים

שם פורמט אירועים תיאור
id מזהה חובה (1) מציינת את המזהה של ביקורת שצריך למחוק מהפיד. המזהה חייב להיות תואם למאפיין המזהה של רכיב <review> בכל קובץ פיד.

מכיל

שם פורמט אירועים תיאור
last_update_timestamp DateTimeWithTimeZone חובה (1) השעה שבה ביקורת הוסרה מהמערכת.

דוגמה: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

דוגמה

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>