בדיקת הסמנטיקה של הפיד
הסמנטיקה של פיד הביקורות היא קצת יותר מורכבת:
לפידים של תמונת מצב של ביקורות:
- אם ספק שמופיע בפיד הביקורות לא קיים כרגע במסד הנתונים של ספקי מודעות 'Google בעלי מקצוע', הביקורות על הספק לא ייכללו בפיד.
- אם ספק שירותים מופיע בפיד הביקורות, והוא קיים כרגע במסד הנתונים של ספקי LSA, הביקורות על הספק יעברו את התהליך הבא:
- לכל ביקורת בפיד, אם הביקורת התואמת לא קיימת באחסון LSA, צריך ליצור אותה.
- אם יש ביקורת תואמת בפיד ובאחסון של LSA, הביקורת תעודכן במידע חדש.
- אם יש ביקורת שלא מופיעה בפיד, אבל יש ביקורת תואמת באחסון של LSA, הביקורת תימחק.
- אם ספק שירותים לא מופיע בפיד הביקורות, אבל הוא קיים כרגע במסד הנתונים של ספקי LSA, הביקורות שלו יימחקו והוא יפסיק להופיע בתוצאות החיפוש.
- שימו לב שגם לספק עם 0 ביקורות צריך להיות רשומה בפידים של הביקורות (ולא להשמיט אותו), כדי שהביקורות יוצגו (ראו דוגמה לביקורת בפיד – listingId 2)
שימו לב: אין תמיכה בפידים מצטברים של ביקורות. לכל פיד פרופיל צריך להיות פיד ביקורות תואם.
טיפול בשגיאות בביקורות
אם פריט פיד של ביקורת לא תקין, אנחנו מדלגים על העיבוד של פריט הפיד הזה וממשיכים לעבד את שאר פריטי הפיד התקינים.
אם פיד הביקורות לא תקין (למשל, לא עומד בדרישות הסכימה), נפסיק את העיבוד של כל פיד הביקורות.
בדיקת השדות
| שם השדה | סוג | תיאור | דוגמה | חובה | מגבלות |
|---|---|---|---|---|---|
| serviceProviderId | number | מזהה ייחודי של כרטיס מוצר (ספק שירות) | 12345 | כן | הערך חייב להתאים ל-int64 |
| ratingCount | מספר שלם | מספר דירוגי הצרכנים המאומתים | 10 | כן | הערך חייב להיות אפס או יותר. |
| מחבר | מחרוזת | השם של מחבר הביקורת | “Jack L.” | לא | |
| reviewId | מחרוזת | המזהה הייחודי של הביקורת. אם לכל ביקורת אין מזהה ייחודי, צריך שצד שלישי ייצור מזהה ייחודי לכל ביקורת (למשל, גיבוב של טקסט הביקורת והמשתמש), לפחות ייחודי בין כל הביקורות מספק אחד. | “123” | כן | |
| reviewText | מחרוזת | קריאת הטקסט של הביקורת שכתב המחבר | "כל הכבוד!" | לא | |
| סיווג | מספר שלם | דירוג (חייב להיות מספר שלם בין 1 ל-5) | 4 | כן | חייב להיות מספר שלם בין 1 ל-5. |
| serviceLocationCity | מחרוזת | העיר שבה השירות בוצע | “New York” | לא | |
| reviewTimestampMicros | מספר שלם | חותמת הזמן שבה נכתבה הביקורת בפורמט מיקרו-שניות. | 1.45142E+15 | לא | |
| serviceTimestampMicros | מספר שלם | חותמת הזמן שבה הסתיים השימוש בשירות בפורמט מיקרו-שניות. | 1.45132E+15 | לא | |
| language | מחרוזת | השפה של הטקסט של הביקורת בפורמט קוד שפה ISO 639-1 (אותיות קטנות, 2 אותיות). חייב להיות זהה לשפת הטירגוט של הספק. | 'en' | לא | השפה צריכה להיות זהה לשפת הטירגוט שצוינה לספק המשויך. אם לא מציינים ערך, ברירת המחדל היא en. |
| קטגוריה | אובייקט | מבנה הקטגוריות | לא | ||
| category->categoryId | טיפוסים בני מנייה (enum) | קטגוריית השירות (בטקסונומיה של מודעות לשירותים מקומיים) | “garage_door_pro” | לא | |
| category->task | טיפוסים בני מנייה (enum) | סוג העבודה (המשימה) של השירות (בטקסונומיה של LSA) | “Repair a Garage Door” (תיקון דלת חניה) | לא | |
| confirmedCustomer | בוליאני | אם הביקורת מגיעה מלקוח מאומת (עם ליד) | TRUE | לא |