אינדקס
DataSourcesService
(ממשק)CreateDataSourceRequest
(הודעה)DataSource
(הודעה)DataSource.Input
(טיפוס טיפוסים בני מנייה (enum))DeleteDataSourceRequest
(הודעה)FetchDataSourceRequest
(הודעה)FileInput
(הודעה)FileInput.FetchSettings
(הודעה)FileInput.FetchSettings.Frequency
(טיפוס טיפוסים בני מנייה (enum))FileInput.FileInputType
(טיפוס טיפוסים בני מנייה (enum))GetDataSourceRequest
(הודעה)ListDataSourcesRequest
(הודעה)ListDataSourcesResponse
(הודעה)LocalInventoryDataSource
(הודעה)PrimaryProductDataSource
(הודעה)PrimaryProductDataSource.Channel
(טיפוס טיפוסים בני מנייה (enum))PromotionDataSource
(הודעה)RegionalInventoryDataSource
(הודעה)SupplementalProductDataSource
(הודעה)UpdateDataSourceRequest
(הודעה)
DataSourcesService
שירות לניהול מקורות נתונים ראשיים, משלימים, מלאי ומקורות נתונים אחרים. מידע נוסף זמין במאמר העזרה של Merchant Center.
CreateDataSource |
---|
יצירת ההגדרה החדשה של מקור הנתונים לחשבון הנתון.
|
DeleteDataSource |
---|
תמחק מקור נתונים מחשבון Merchant Center.
|
FetchDataSource |
---|
מתבצע אחזור של הנתונים באופן מיידי (גם מחוץ לתזמון השליפה) במקור נתונים מחשבון Merchant Center. אם אתם צריכים לקרוא לשיטה הזו יותר מפעם ביום, תוכלו להשתמש בשירות 'מוצרים' כדי לעדכן את נתוני המוצרים שלכם. השיטה הזו פועלת רק במקורות נתונים שהוגדר בהם קלט של קובץ.
|
GetDataSource |
---|
מאחזר את ההגדרות של מקור הנתונים של החשבון הנתון.
|
ListDataSources |
---|
רשימה של ההגדרות של מקורות הנתונים של החשבון הנתון.
|
UpdateDataSource |
---|
עדכון ההגדרה הקיימת של מקור הנתונים. השדות שהוגדרו במסכת העדכון אבל לא סופקו במשאב יימחקו.
|
CreateDataSourceRequest
הודעת בקשה ל-method של CreateDataSource.
שדות | |
---|---|
parent |
חובה. החשבון שבו ייווצר מקור הנתונים הזה. פורמט: |
data_source |
חובה. מקור הנתונים שצריך ליצור. |
DataSource
מקור הנתונים של חשבון Merchant Center.
שדות | |
---|---|
name |
מזהה. שם מקור הנתונים. פורמט: |
data_source_id |
פלט בלבד. מזהה מקור הנתונים |
display_name |
חובה. שם מקור הנתונים שמוצג בממשק המשתמש של Merchant Center. |
input |
פלט בלבד. ההגדרה קובעת את סוג הקלט למקור הנתונים. ייתכן שחלק מההגדרות לא יפעלו, בהתאם לקלט. ניתן ליצור רק מקורות נתונים גנריים באמצעות ה-API. |
file_input |
זה שינוי אופציונלי. נעשה שימוש בשדה רק כשהנתונים מנוהלים באמצעות קובץ. |
שדה איחוד Type . סוג של מקור נתונים. Type יכול להיות רק אחת מהאפשרויות הבאות: |
|
primary_product_data_source |
חובה. מקור הנתונים הראשי למוצרים בחנויות מקומיות ומוצרים אונליין. |
supplemental_product_data_source |
חובה. מקור הנתונים המשלים למוצרים בחנויות מקומיות ומוצרים אונליין. |
local_inventory_data_source |
חובה. מקור הנתונים של מלאי בחנות מקומית. |
regional_inventory_data_source |
חובה. מקור הנתונים של מלאי אזורי. |
promotion_data_source |
חובה. מקור הנתונים של המבצע. |
קלט
ההגדרה קובעת את סוג הקלט למקור הנתונים. בהתאם לקלט, יכול להיות שחלק מההגדרות לא נתמכות.
טיפוסים בני מנייה (enum) | |
---|---|
INPUT_UNSPECIFIED |
לא צוין קלט. |
API |
מייצג את מקורות הנתונים שעבורם רוב הנתונים סופקו דרך ה-API. |
FILE |
מייצג את מקורות הנתונים שעבורם הנתונים סופקו בעיקר באמצעות קלט של קובץ. עדיין אפשר לספק את הנתונים באמצעות ה-API. |
UI |
מקור הנתונים של מוצרים שנוספו ישירות ב-Merchant Center. אי אפשר ליצור או לעדכן מקור נתונים מהסוג הזה באמצעות ה-API הזה, אלא רק בממשק המשתמש של Merchant Center. מקור נתונים מהסוג הזה הוא לקריאה בלבד. |
AUTOFEED |
העדכונים האלה נקראים גם פידים אוטומטיים שמשמשים ליצירה אוטומטית של נתוני המוצרים. ניתן להפעיל או להשבית מקור נתונים מהסוג הזה באמצעות חבילת החשבונות. |
DeleteDataSourceRequest
הודעת בקשה ל-method DeleteDataSource.
שדות | |
---|---|
name |
חובה. שם מקור הנתונים למחיקה. פורמט: |
FetchDataSourceRequest
הודעת בקשה לשיטת FetchDataSource.
שדות | |
---|---|
name |
חובה. שם המשאב של מקור הנתונים לאחזור. פורמט: |
FileInput
נתונים ספציפיים למקורות נתונים של קבצים. השדה הזה ריק עבור מקורות קלט אחרים של נתונים.
שדות | |
---|---|
fetch_settings |
זה שינוי אופציונלי. מאחזרים את הפרטים כדי להעביר את מקור הנתונים. הוא מכיל הגדרות עבור סוגי קלט של קבצים |
file_name |
זה שינוי אופציונלי. שם הקובץ של מקור הנתונים. נדרש עבור סוג קלט של קובץ |
file_input_type |
פלט בלבד. סוג הקלט של הקובץ. |
FetchSettings
מאחזרים את הפרטים כדי להעביר את מקור הנתונים.
שדות | |
---|---|
enabled |
זה שינוי אופציונלי. המתג מפעיל או משהה את תזמון השליפה. |
day_of_month |
זה שינוי אופציונלי. היום בחודש שבו צריך לאחזר את הקובץ של מקור הנתונים (1 עד 31). ניתן להגדיר את השדה הזה לתדירות חודשית בלבד. |
time_of_day |
זה שינוי אופציונלי. השעה ביום שבה יש לאחזר את קובץ מקור הנתונים. דקות ושניות לא נתמכות והמערכת תתעלם מהן. |
day_of_week |
זה שינוי אופציונלי. היום בשבוע שבו יש לאחזר את קובץ מקור הנתונים. ניתן להגדיר את השדה הזה רק לתדירות שבועית. |
time_zone |
זה שינוי אופציונלי. אזור הזמן שמוגדר ללוח הזמנים. לפי שעון UTC כברירת מחדל. לדוגמה, "America/Los_Angeles". |
frequency |
חובה. התדירות שמתארת את לוח הזמנים לשליפה. |
fetch_uri |
זה שינוי אופציונלי. כתובת ה-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. |
תדירות
שדות החובה משתנים בהתאם לתדירות השליפה. בשביל תזמון שליפה חודשי, נדרשים [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 |
הקובץ יאוחזר מה-[fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] שהוגדרה. |
GOOGLE_SHEETS |
הקובץ אוחזר מ-Google Sheets שצוין ב-[fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GetDataSourceRequest
הודעת בקשה ל-method GetDataSource.
שדות | |
---|---|
name |
חובה. שם מקור הנתונים שצריך לאחזר. פורמט: |
ListDataSourcesRequest
הודעת בקשה ל-method ListDataSources.
שדות | |
---|---|
parent |
חובה. החשבון שעבורו יש להציג רשימה של מקורות נתונים. פורמט: |
page_size |
זה שינוי אופציונלי. המספר המקסימלי של מקורות נתונים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000; ערכים מעל 1000 יקובצו ל-1000. אם לא צוין, המערכת תחזיר את המספר המקסימלי של מקורות נתונים. |
page_token |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListDataSourcesResponse
הודעת תגובה ל-method ListDataSources.
שדות | |
---|---|
data_sources[] |
מקורות הנתונים מהחשבון שצוין. |
next_page_token |
אסימון, שניתן לשלוח בתור |
LocalInventoryDataSource
מקור הנתונים של המלאי בחנות מקומית.
שדות | |
---|---|
feed_label |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם צוין המלאי בחנות המקומית. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. |
content_language |
חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם נשלח המלאי בחנות המקומית. |
PrimaryProductDataSource
מקור הנתונים הראשי למוצרים בחנויות מקומיות ואונליין.
שדות | |
---|---|
channel |
חובה. בלתי ניתן לשינוי. מציין את סוג הערוץ של מקור הנתונים. |
countries[] |
זה שינוי אופציונלי. המדינות שבהן הפריטים יכולים להופיע. מיוצג כקוד של אזור CLDR. |
feed_label |
זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. צריך להגדיר או להגדיר גם את המדיניות אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
content_language |
זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. צריך להגדיר את אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
ערוץ
ערוץ מקור הנתונים.
הערוץ משמש להבחנה בין מקורות נתונים לענפים שונים של מוצרים.
טיפוסים בני מנייה (enum) | |
---|---|
CHANNEL_UNSPECIFIED |
לא צוין. |
ONLINE_PRODUCTS |
מוצר אונליין. |
LOCAL_PRODUCTS |
מוצר בחנות מקומית. |
PRODUCTS |
מקור נתונים מאוחד למוצרים מקומיים ולמוצרים אונליין. הערה: בערוץ הזה לא ניתן לנהל מוצרים באמצעות ה-API. |
PromotionDataSource
מקור הנתונים של המבצע.
שדות | |
---|---|
target_country |
חובה. בלתי ניתן לשינוי. מדינת היעד שמשמשת כחלק מהמזהה הייחודי. מיוצג כקוד של אזור CLDR. מבצעים זמינים רק במדינות מסוימות. |
content_language |
חובה. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. |
RegionalInventoryDataSource
מקור נתוני המלאי האזורי.
שדות | |
---|---|
feed_label |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם סופק המלאי האזורי. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. |
content_language |
חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם מסופק המלאי האזורי. |
SupplementalProductDataSource
מקור הנתונים המשלים למוצרים בחנויות מקומיות ואונליין.
שדות | |
---|---|
feed_label |
זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-). למידע נוסף, ראו מעבר לתוויות פיד. צריך להגדיר או להגדיר גם את המדיניות אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
content_language |
זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1. צריך להגדיר את אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
UpdateDataSourceRequest
הודעת בקשה ל-method של UpdateDataSource.
שדות | |
---|---|
data_source |
חובה. המשאב של מקור הנתונים שצריך לעדכן. |
update_mask |
חובה. רשימת השדות של מקור הנתונים שיש לעדכן. שדות שצוינו במסכת העדכון ללא ערך שצוין בגוף הנתונים יימחקו ממקור הנתונים. הוספת "*" מיוחד אין תמיכה בערך של החלפה מלאה של מקור נתונים. |