- משאב: מקור נתונים
- PrimaryProductDataSource
- ערוץ
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- קלט
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- תדירות
- FileInputType
- שיטות
משאב: מקור נתונים
מקור הנתונים של חשבון Merchant Center.
ייצוג JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
שדות | |
---|---|
name |
מזהה. שם מקור הנתונים. פורמט: |
dataSourceId |
פלט בלבד. מזהה מקור הנתונים |
displayName |
חובה. שם מקור הנתונים שמוצג בממשק המשתמש של Merchant Center. |
input |
פלט בלבד. ההגדרה קובעת את סוג הקלט למקור הנתונים. ייתכן שחלק מההגדרות לא יפעלו, בהתאם לקלט. ניתן ליצור רק מקורות נתונים גנריים באמצעות ה-API. |
fileInput |
זה שינוי אופציונלי. נעשה שימוש בשדה רק כשהנתונים מנוהלים באמצעות קובץ. |
שדה איחוד Type . סוג של מקור נתונים. Type יכול להיות רק אחת מהאפשרויות הבאות: |
|
primaryProductDataSource |
חובה. מקור הנתונים הראשי למוצרים בחנויות מקומיות ומוצרים אונליין. |
supplementalProductDataSource |
חובה. מקור הנתונים המשלים למוצרים בחנויות מקומיות ומוצרים אונליין. |
localInventoryDataSource |
חובה. מקור הנתונים של מלאי בחנות מקומית. |
regionalInventoryDataSource |
חובה. מקור הנתונים של מלאי אזורי. |
promotionDataSource |
חובה. מקור הנתונים של המבצע. |
PrimaryProductDataSource
מקור הנתונים הראשי למוצרים בחנויות מקומיות ואונליין.
ייצוג JSON |
---|
{
"channel": enum ( |
שדות | |
---|---|
channel |
חובה. בלתי ניתן לשינוי. מציין את סוג הערוץ של מקור הנתונים. |
countries[] |
זה שינוי אופציונלי. המדינות שבהן הפריטים יכולים להופיע. מיוצג כקוד של אזור CLDR. |
feedLabel |
זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. צריך להגדיר או להגדיר גם את המדיניות אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
contentLanguage |
זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. צריך להגדיר את אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
ערוץ
ערוץ מקור הנתונים.
הערוץ משמש להבחנה בין מקורות נתונים לענפים שונים של מוצרים.
טיפוסים בני מנייה (enum) | |
---|---|
CHANNEL_UNSPECIFIED |
לא צוין. |
ONLINE_PRODUCTS |
מוצר אונליין. |
LOCAL_PRODUCTS |
מוצר בחנות מקומית. |
PRODUCTS |
מקור נתונים מאוחד למוצרים מקומיים ולמוצרים אונליין. הערה: בערוץ הזה לא ניתן לנהל מוצרים באמצעות ה-API. |
SupplementalProductDataSource
מקור הנתונים המשלים למוצרים בחנויות מקומיות ואונליין.
ייצוג JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
שדות | |
---|---|
feedLabel |
זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. צריך להגדיר או להגדיר גם את המדיניות אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
contentLanguage |
זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. צריך להגדיר את אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
LocalInventoryDataSource
מקור הנתונים של המלאי בחנות מקומית.
ייצוג JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
שדות | |
---|---|
feedLabel |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם צוין המלאי בחנות המקומית. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. |
contentLanguage |
חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם נשלח המלאי בחנות המקומית. |
RegionalInventoryDataSource
מקור נתוני המלאי האזורי.
ייצוג JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
שדות | |
---|---|
feedLabel |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם סופק המלאי האזורי. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. |
contentLanguage |
חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם מסופק המלאי האזורי. |
PromotionDataSource
מקור הנתונים של המבצע.
ייצוג JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
שדות | |
---|---|
targetCountry |
חובה. בלתי ניתן לשינוי. מדינת היעד שמשמשת כחלק מהמזהה הייחודי. מיוצג כקוד של אזור CLDR. מבצעים זמינים רק במדינות מסוימות. |
contentLanguage |
חובה. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. |
קלט
ההגדרה קובעת את סוג הקלט למקור הנתונים. בהתאם לקלט, יכול להיות שחלק מההגדרות לא נתמכות.
טיפוסים בני מנייה (enum) | |
---|---|
INPUT_UNSPECIFIED |
לא צוין קלט. |
API |
מייצג את מקורות הנתונים שעבורם רוב הנתונים סופקו דרך ה-API. |
FILE |
מייצג את מקורות הנתונים שעבורם הנתונים סופקו בעיקר באמצעות קלט של קובץ. עדיין אפשר לספק את הנתונים באמצעות ה-API. |
UI |
מקור הנתונים של מוצרים שנוספו ישירות ב-Merchant Center. אי אפשר ליצור או לעדכן מקור נתונים מהסוג הזה באמצעות ה-API הזה, אלא רק בממשק המשתמש של Merchant Center. מקור נתונים מהסוג הזה הוא לקריאה בלבד. |
AUTOFEED |
העדכונים האלה נקראים גם פידים אוטומטיים שמשמשים ליצירה אוטומטית של נתוני המוצרים. ניתן להפעיל או להשבית מקור נתונים מהסוג הזה באמצעות חבילת החשבונות. |
FileInput
נתונים ספציפיים למקורות נתונים של קבצים. השדה הזה ריק עבור מקורות קלט אחרים של נתונים.
ייצוג JSON |
---|
{ "fetchSettings": { object ( |
שדות | |
---|---|
fetchSettings |
זה שינוי אופציונלי. מאחזרים את הפרטים כדי להעביר את מקור הנתונים. הוא מכיל הגדרות עבור סוגי קלט של קבצים |
fileName |
זה שינוי אופציונלי. שם הקובץ של מקור הנתונים. נדרש עבור סוג קלט של קובץ |
fileInputType |
פלט בלבד. סוג הקלט של הקובץ. |
FetchSettings
מאחזרים את הפרטים כדי להעביר את מקור הנתונים.
ייצוג JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
שדות | |
---|---|
enabled |
זה שינוי אופציונלי. המתג מפעיל או משהה את תזמון השליפה. |
dayOfMonth |
זה שינוי אופציונלי. היום בחודש שבו יש לאחזר את הקובץ של מקור הנתונים (1 עד 31). ניתן להגדיר את השדה הזה לתדירות חודשית בלבד. |
timeOfDay |
זה שינוי אופציונלי. השעה ביום שבה יש לאחזר את קובץ מקור הנתונים. דקות ושניות לא נתמכות והמערכת תתעלם מהן. |
dayOfWeek |
זה שינוי אופציונלי. היום בשבוע שבו יש לאחזר את קובץ מקור הנתונים. ניתן להגדיר את השדה הזה רק לתדירות שבועית. |
timeZone |
זה שינוי אופציונלי. אזור הזמן שמוגדר ללוח הזמנים. לפי שעון UTC כברירת מחדל. לדוגמה, "America/Los_Angeles". |
frequency |
חובה. התדירות שמתארת את לוח הזמנים לשליפה. |
fetchUri |
זה שינוי אופציונלי. כתובת ה-URL שאליה ניתן לאחזר את קובץ מקור הנתונים. מערכת Google Merchant Center תומכת בהעלאות מתוזמנות אוטומטיות באמצעות הפרוטוקולים HTTP, HTTPS או SFTP, ולכן הערך צריך להיות קישור תקין שמשתמש באחד משלושת הפרוטוקולים האלה. לא ניתן לשינוי בקובצי Google Sheets. |
username |
זה שינוי אופציונלי. שם משתמש אופציונלי ל[fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. משמש לשליחת מקורות נתונים באמצעות SFTP. |
password |
זה שינוי אופציונלי. סיסמה אופציונלית ל[fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. משמש לשליחת מקורות נתונים באמצעות SFTP. |
TimeOfDay
מייצג שעה ביום. התאריך ואזור הזמן לא משמעותיים או שהם מצוינים במקום אחר. יכול להיות ש-API יבחר לאפשר שניות מדלגות. הסוגים הקשורים הם google.type.Date
ו-google.protobuf.Timestamp
.
ייצוג JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
שדות | |
---|---|
hours |
שעות ביום בפורמט 24 שעות. צריך להיות מספר בין 0 ל-23. ממשק API עשוי לבחור לאפשר את הערך '24:00:00' לתרחישים כמו שעת הסגירה של העסק. |
minutes |
דקות בשעה ביום. חייב להיות בין 0 ל-59. |
seconds |
שניות ודקות. בדרך כלל הערך צריך להיות בין 0 ל-59. ה-API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות מדלגות. |
nanos |
שברי שניות בננו-שניות. חייב להיות בין 0 ל-999,999,999. |
DayOfWeek
מייצג יום בשבוע.
טיפוסים בני מנייה (enum) | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
היום בשבוע לא צוין. |
MONDAY |
שני |
TUESDAY |
שלישי |
WEDNESDAY |
רביעי |
THURSDAY |
חמישי |
FRIDAY |
שישי |
SATURDAY |
שבת |
SUNDAY |
ראשון |
תדירות
שדות החובה משתנים בהתאם לתדירות השליפה. בשביל תזמון שליפה חודשי, נדרשים [day of month][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] ו-[Hour of day][google.shopping.content.bundles.DataSources.FileInput.Fetch.time_of_day]. כדי להשתמש בלוח זמנים שבועי לשליפה, נדרשים [day of week][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] ו-[hour of day][google.shopping.content.bundles.DataSources.FileInput.Fetch.time_of_day]. עבור תזמון שליפה יומי, נדרשת רק [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].
טיפוסים בני מנייה (enum) | |
---|---|
FREQUENCY_UNSPECIFIED |
לא צוינה תדירות. |
FREQUENCY_DAILY |
האחזור מתבצע מדי יום. |
FREQUENCY_WEEKLY |
האחזור מתבצע מדי שבוע. |
FREQUENCY_MONTHLY |
האחזור מתבצע מדי חודש. |
FileInputType
השיטה להעברת הקבצים.
טיפוסים בני מנייה (enum) | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
לא צוין סוג קלט של קובץ. |
UPLOAD |
אפשר להעלות את הקובץ באמצעות SFTP, Google Cloud Storage או באופן ידני ל-Merchant Center. |
FETCH |
הקובץ יאוחזר מה-[fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GOOGLE_SHEETS |
הקובץ אוחזר מ-Google Sheets שצוין ב-[fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
שיטות |
|
---|---|
|
יצירת ההגדרה החדשה של מקור הנתונים לחשבון הנתון. |
|
תמחק מקור נתונים מחשבון Merchant Center. |
|
מתבצע אחזור של הנתונים באופן מיידי (גם מחוץ לתזמון השליפה) במקור נתונים מחשבון Merchant Center. |
|
מאחזר את ההגדרות של מקור הנתונים של החשבון הנתון. |
|
רשימה של ההגדרות של מקורות הנתונים של החשבון הנתון. |
|
עדכון ההגדרה הקיימת של מקור הנתונים. |