אינדקס
DataSourcesService
(ממשק)FileUploadsService
(ממשק)CreateDataSourceRequest
(הודעה)DataSource
(הודעה)DataSource.Input
(enum)DataSourceReference
(הודעה)DeleteDataSourceRequest
(הודעה)FetchDataSourceRequest
(הודעה)FileInput
(הודעה)FileInput.FetchSettings
(הודעה)FileInput.FetchSettings.Frequency
(enum)FileInput.FileInputType
(enum)FileUpload
(הודעה)FileUpload.Issue
(הודעה)FileUpload.Issue.Severity
(enum)FileUpload.ProcessingState
(enum)GetDataSourceRequest
(הודעה)GetFileUploadRequest
(הודעה)ListDataSourcesRequest
(הודעה)ListDataSourcesResponse
(הודעה)LocalInventoryDataSource
(הודעה)MerchantReviewDataSource
(הודעה)PrimaryProductDataSource
(הודעה)PrimaryProductDataSource.Channel
(enum)PrimaryProductDataSource.DefaultRule
(הודעה)ProductReviewDataSource
(הודעה)PromotionDataSource
(הודעה)RegionalInventoryDataSource
(הודעה)SupplementalProductDataSource
(הודעה)UpdateDataSourceRequest
(הודעה)
DataSourcesService
שירות לניהול מקורות נתונים ראשיים, משלימים, מלאי ומקורות נתונים אחרים. מידע נוסף זמין במאמר העזרה בנושא Merchant Center.
CreateDataSource |
---|
יצירת ההגדרה החדשה של מקור הנתונים בחשבון הנתון.
|
DeleteDataSource |
---|
מחיקה של מקור נתונים מחשבון Merchant Center.
|
FetchDataSource |
---|
אחזור הנתונים מתבצע באופן מיידי (גם מחוץ ללוח הזמנים לאחזור) ממקור נתונים בחשבון Merchant Center. אם צריך להפעיל את השיטה הזו יותר מפעם ביום, צריך להשתמש בשירות Products כדי לעדכן את נתוני המוצרים במקום זאת. השיטה הזו פועלת רק במקורות נתונים עם הגדרת קלט של קובץ.
|
GetDataSource |
---|
אחזור ההגדרה של מקור הנתונים בחשבון הנתון.
|
ListDataSources |
---|
הצגת ההגדרות של מקורות הנתונים בחשבון הנתון.
|
UpdateDataSource |
---|
עדכון ההגדרה הקיימת של מקור הנתונים. השדות שמוגדרים במסכת העדכון אבל לא צוינו במשאב יימחקו.
|
FileUploadsService
שירות לניהול העלאות של קובצי מקורות נתונים.
GetFileUpload |
---|
הפונקציה מקבלת את קובץ ההעלאה האחרון של מקור הנתונים. רק כתובת האימייל החלופית
|
CreateDataSourceRequest
הודעת הבקשה של שיטת CreateDataSource.
שדות | |
---|---|
parent |
חובה. החשבון שבו ייווצר מקור הנתונים הזה. פורמט: |
data_ |
חובה. מקור הנתונים שייווצר. |
DataSource
מקור הנתונים של חשבון Merchant Center.
שדות | |
---|---|
name |
מזהה. השם של מקור הנתונים. פורמט: |
data_ |
פלט בלבד. מזהה מקור הנתונים. |
display_ |
חובה. השם של מקור הנתונים שמוצג בממשק המשתמש של Merchant Center. |
input |
פלט בלבד. קובע את סוג הקלט למקור הנתונים. בהתאם לקלט, יכול להיות שחלק מההגדרות לא יפעלו. אפשר ליצור רק מקורות נתונים כלליים דרך ה-API. |
file_ |
זה שינוי אופציונלי. השדה נמצא בשימוש רק כשהנתונים מנוהלים באמצעות קובץ. |
שדה האיחוד Type . סוג מקור הנתונים. הערך של Type יכול להיות רק אחת מהאפשרויות הבאות: |
|
primary_ |
חובה. מקור הנתונים הראשי של מוצרים מקומיים ובאינטרנט. |
supplemental_ |
חובה. מקור הנתונים המשלים למוצרים בחנויות מקומיות ובאינטרנט. |
local_ |
חובה. מקור הנתונים של המלאי בחנות המקומית. |
regional_ |
חובה. מקור הנתונים של המלאי האזורי. |
promotion_ |
חובה. מקור הנתונים של המבצע. |
product_ |
חובה. מקור הנתונים ביקורות על מוצרים. |
merchant_ |
חובה. מקור הנתונים ביקורת על מוכר. |
קלט
קובע את סוג הקלט למקור הנתונים. בהתאם לקלט, יכול להיות שחלק מההגדרות לא יהיו נתמכות.
טיפוסים בני מנייה (enum) | |
---|---|
INPUT_UNSPECIFIED |
הקלט לא צוין. |
API |
מייצג מקורות נתונים שהנתונים שלהם ניתנים בעיקר דרך ה-API. |
FILE |
מייצג מקורות נתונים שבהם הנתונים ניתנים בעיקר באמצעות קלט של קובץ. עדיין אפשר לספק נתונים דרך ה-API. |
UI |
מקור הנתונים של מוצרים שנוספו ישירות ב-Merchant Center. אי אפשר ליצור או לעדכן את סוג מקור הנתונים הזה דרך ה-API הזה, אלא רק דרך ממשק המשתמש של Merchant Center. סוג מקור הנתונים הזה הוא לקריאה בלבד. |
AUTOFEED |
האפשרות הזו נקראת גם פידים אוטומטיים, והיא משמשת ליצירה אוטומטית של נתוני המוצרים. אפשר להפעיל או להשבית את מקור הנתונים הזה דרך חבילת החשבונות. |
DataSourceReference
אפשר להשתמש בהפניה למקור נתונים כדי לנהל מקורות נתונים קשורים בשירות של מקור הנתונים.
שדות | |
---|---|
שדה האיחוד הערך של |
|
self |
צריך להשתמש ב-Self כדי להפנות למקור הנתונים הראשי עצמו. |
primary_ |
זה שינוי אופציונלי. השם של מקור הנתונים הראשי. פורמט: |
supplemental_ |
זה שינוי אופציונלי. השם של מקור הנתונים המשלים. פורמט: |
DeleteDataSourceRequest
הודעת הבקשה של שיטת DeleteDataSource.
שדות | |
---|---|
name |
חובה. השם של מקור הנתונים שרוצים למחוק. פורמט: |
FetchDataSourceRequest
הודעת הבקשה לשיטה FetchDataSource.
שדות | |
---|---|
name |
חובה. השם של המשאב של מקור הנתונים לאחזור. פורמט: |
FileInput
הנתונים הספציפיים למקורות נתונים של קבצים. השדה הזה ריק עבור קלט של מקורות נתונים אחרים.
שדות | |
---|---|
fetch_ |
זה שינוי אופציונלי. אחזור פרטים כדי לספק את מקור הנתונים. הוא מכיל הגדרות לסוגי קלט של קבצים מסוג |
file_ |
זה שינוי אופציונלי. שם הקובץ של מקור הנתונים. חובה לסוג הקלט של קובץ |
file_ |
פלט בלבד. סוג הקלט של הקובץ. |
FetchSettings
אחזור פרטים כדי לספק את מקור הנתונים.
שדות | |
---|---|
enabled |
זה שינוי אופציונלי. הפעלה או השהיה של לוח הזמנים לאחזור. |
day_ |
זה שינוי אופציונלי. היום בחודש שבו צריך לאחזר את הקובץ של מקור הנתונים (1-31). אפשר להגדיר את השדה הזה רק לתדירות חודשית. |
time_ |
זה שינוי אופציונלי. השעה ביום שבה צריך לאחזר את קובץ מקור הנתונים. אין תמיכה בדקות ובשניות, והן יימחקו. |
day_ |
זה שינוי אופציונלי. היום בשבוע שבו צריך לאחזר את קובץ מקור הנתונים. אפשר להגדיר את השדה הזה רק לתדירות שבועית. |
time_ |
זה שינוי אופציונלי. אזור הזמן שבו נעשה שימוש לתזמון. UTC כברירת מחדל. לדוגמה, 'America/Los_Angeles'. |
frequency |
חובה. התדירות שמתארת את לוח הזמנים לאחזור. |
fetch_ |
זה שינוי אופציונלי. כתובת ה-URL שממנה ניתן לאחזר את קובץ מקור הנתונים. מערכת Google Merchant Center תומכת בהעלאות מתוזמנות אוטומטיות באמצעות הפרוטוקולים HTTP, HTTPS או SFTP, כך שהערך צריך להיות קישור תקין באמצעות אחד משלושת הפרוטוקולים האלה. לא ניתן לשנות את השם של קובצי Google Sheets. |
username |
זה שינוי אופציונלי. שם משתמש אופציונלי ל- |
password |
זה שינוי אופציונלי. סיסמה אופציונלית ל- |
תדירות
השדות הנדרשים משתנים בהתאם לתדירות האחזור. בלוח זמנים לאחזור חודשי, צריך לציין את הערכים של [יום בחודש][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] ושל [שעה ביום][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. בלוח זמנים לשליפת נתונים שבועי, צריך לציין את [יום השבוע][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] ואת [שעה ביום][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_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_SHEETS |
הקובץ מאוחזר מ-Google Sheets שצוין ב-fetch_uri . |
FileUpload
העלאת הקובץ של מקור נתונים ספציפי, כלומר התוצאה של אחזור מקור הנתונים בחותמת זמן מסוימת, שמחושבת באופן אסינכרוני בסיום העיבוד של מקור הנתונים. האפשרות הזו רלוונטית רק למקורות נתונים מסוג קובץ.
שדות | |
---|---|
name |
מזהה. השם של קובץ מקור הנתונים שמעלים. פורמט: |
data_ |
פלט בלבד. מזהה מקור הנתונים. |
processing_ |
פלט בלבד. מצב העיבוד של מקור הנתונים. |
issues[] |
פלט בלבד. רשימת הבעיות במקור הנתונים. |
items_ |
פלט בלבד. מספר הפריטים במקור הנתונים שעברו עיבוד. |
items_ |
פלט בלבד. מספר הפריטים שנוצרו במקור הנתונים. |
items_ |
פלט בלבד. מספר הפריטים במקור הנתונים שעודכנו. |
upload_ |
פלט בלבד. התאריך שבו הועלה הקובץ של מקור הנתונים. |
בעיה
שגיאה שמתרחשת במקור הנתונים, כמו 'מחיר לא חוקי'.
שדות | |
---|---|
title |
פלט בלבד. שם הבעיה, לדוגמה, 'הפריט גדול מדי'. |
description |
פלט בלבד. תיאור השגיאה, לדוגמה, "מקור הנתונים מכיל פריטים גדולים מדי או עם יותר מדי מאפיינים. הפריטים האלה יוסרו". |
code |
פלט בלבד. קוד השגיאה, לדוגמה, validation/invalid_value. הפונקציה מחזירה את הערך '?' אם הקוד לא ידוע. |
count |
פלט בלבד. מספר המקרים שבהם השגיאה התרחשה בהעלאת הקובץ. |
severity |
פלט בלבד. חומרת הבעיה. |
documentation_ |
פלט בלבד. קישור לתיעוד שבו מוסבר על הבעיה בפירוט רב יותר, אם יש כזה. |
מידת החומרה
חומרת הבעיה.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
רמת החומרה לא צוינה. |
WARNING |
הבעיה היא האזהרה. |
ERROR |
הבעיה היא שגיאה. |
ProcessingState
מצב העיבוד של מקור הנתונים.
טיפוסים בני מנייה (enum) | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
לא צוין מצב העיבוד. |
FAILED |
לא ניתן היה לעבד את מקור הנתונים או שכל הפריטים הכילו שגיאות. |
IN_PROGRESS |
מקור הנתונים נמצא בעיבוד. |
SUCCEEDED |
מקור הנתונים עובד בהצלחה, אבל יכול להיות שיהיו שגיאות בחלק מהפריטים. |
GetDataSourceRequest
הודעת הבקשה לשיטה GetDataSource.
שדות | |
---|---|
name |
חובה. השם של מקור הנתונים לאחזור. פורמט: |
GetFileUploadRequest
הודעת הבקשה לשיטה GetFileUploadRequest.
שדות | |
---|---|
name |
חובה. השם של קובץ מקור הנתונים להעלאה לאחזור. פורמט: |
ListDataSourcesRequest
הודעת הבקשה לשיטה ListDataSources.
שדות | |
---|---|
parent |
חובה. החשבון שבו רוצים להציג את רשימת מקורות הנתונים. פורמט: |
page_ |
זה שינוי אופציונלי. המספר המקסימלי של מקורות הנתונים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יומרו לערך 1,000. אם לא מצוין, יופיע המספר המקסימלי של מקורות הנתונים. |
page_ |
זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של כשמחלקים את הדפים, כל שאר הפרמטרים שסופקו ל- |
ListDataSourcesResponse
הודעת התגובה של השיטה ListDataSources.
שדות | |
---|---|
data_ |
מקורות הנתונים מהחשבון שצוין. |
next_ |
אסימון שאפשר לשלוח כ- |
LocalInventoryDataSource
מקור הנתונים של המלאי בחנות המקומית.
שדות | |
---|---|
feed_ |
חובה. לא ניתן לשינוי. תווית הפיד של המוצרים שעבורם המלאי בחנות המקומית מסופק. המזהה צריך להכיל 20 תווים לכל היותר, שכוללים אותיות רישיות (A-Z), ספרות (0-9) ומקפים (-). מידע נוסף זמין במאמר מעבר לתוויות פיד. |
content_ |
חובה. לא ניתן לשינוי. קוד השפה בן שתי האותיות לפי תקן ISO 639-1 של הפריטים שבהם מוצג המלאי המקומי. |
MerchantReviewDataSource
אין שדות לסוג הזה.
מקור הנתונים של הביקורות על המוכר.
PrimaryProductDataSource
מקור הנתונים הראשי של מוצרים מקומיים ובאינטרנט.
שדות | |
---|---|
channel |
חובה. לא ניתן לשינוי. מציין את סוג הערוץ של מקור הנתונים. |
countries[] |
זה שינוי אופציונלי. המדינות שבהן הפריטים עשויים להופיע. מיוצג כקוד טריטוריה של מאגר CLDR. |
default_ |
זה שינוי אופציונלי. ניהול כללי ברירת המחדל של מקור הנתונים. אם ההגדרה הזו מוגדרת, מקורות הנתונים המקושרים יוחלפו. |
feed_ |
זה שינוי אופציונלי. לא ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. המזהה צריך להכיל 20 תווים לכל היותר, שכוללים אותיות רישיות (A-Z), ספרות (0-9) ומקפים (-). מידע נוסף זמין במאמר מעבר לתוויות פיד. צריך להגדיר את הפרמטרים אם ההגדרה הזו מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם לא תגדירו את הערך, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
content_ |
זה שינוי אופציונלי. לא ניתן לשינוי. קוד השפה בן שתי האותיות לפי תקן ISO 639-1 של הפריטים במקור הנתונים. הערכים של אם ההגדרה הזו מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם לא תגדירו את הערך, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
ערוץ
ערוץ של מקור הנתונים.
הערוץ משמש להבדיל בין מקורות נתונים של קטגוריות מוצרים שונות.
טיפוסים בני מנייה (enum) | |
---|---|
CHANNEL_UNSPECIFIED |
לא צוין. |
ONLINE_PRODUCTS |
מוצר אונליין. |
LOCAL_PRODUCTS |
מוצר בחנות מקומית. |
PRODUCTS |
מקור נתונים מאוחד למוצרים בחנויות מקומיות ולמוצרים באינטרנט. הערה: אי אפשר לנהל את המוצרים דרך ה-API בערוץ הזה. |
DefaultRule
ניהול כללי ברירת המחדל של מקור הנתונים.
שדות | |
---|---|
take_ |
חובה. רשימת מקורות הנתונים שמקושרים בכלל ברירת המחדל. הרשימה הזו ממוינת לפי עדיפות ברירת המחדל של הכלל שבו מתבצעת ההצטרפות של הנתונים. יכול להיות שהיא לא תכלול אף הפניה ל- הרשימה לא יכולה להיות ריקה. כדי לקשר את מקור הנתונים לכלל ברירת המחדל, צריך להוסיף לרשימה הזו הפניה חדשה (בסדר כרונולוגי). כדי לבטל את הקישור של מקור הנתונים לכלל ברירת המחדל, צריך להסיר את ההפניה הרלוונטית מהרשימה הזו. שינוי הסדר של הרשימה הזו ישנה את העדיפות של מקורות הנתונים בכלל ברירת המחדל. לדוגמה, אם תספקו את הרשימה הבאה: [ |
ProductReviewDataSource
אין שדות לסוג הזה.
מקור הנתונים של הביקורות על המוצר.
PromotionDataSource
מקור נתוני המבצע.
שדות | |
---|---|
target_ |
חובה. לא ניתן לשינוי. מדינת היעד שמשויכת למזהה הייחודי. מיוצג כקוד טריטוריה של מאגר CLDR. התכונה 'מבצעים' זמינה רק במדינות נבחרות. |
content_ |
חובה. לא ניתן לשינוי. קוד השפה בן שתי האותיות לפי תקן ISO 639-1 של הפריטים במקור הנתונים. |
RegionalInventoryDataSource
מקור הנתונים של המלאי האזורי.
שדות | |
---|---|
feed_ |
חובה. לא ניתן לשינוי. תווית הפיד של המוצרים שעבורם המלאי האזורי מסופק. המזהה צריך להכיל 20 תווים לכל היותר, שכוללים אותיות רישיות (A-Z), ספרות (0-9) ומקפים (-). מידע נוסף זמין במאמר מעבר לתוויות פיד. |
content_ |
חובה. לא ניתן לשינוי. השפה של הפריטים שבהם מוצג מלאי שטחי הפרסום האזורי, לפי תקן ISO 639-1 בן שתי האותיות. |
SupplementalProductDataSource
מקור הנתונים המשלים למוצרים בחנויות מקומיות ובאינטרנט. אחרי היצירה, חשוב לקשר את מקור נתוני המוצרים המשלים למקור נתוני מוצרים ראשי אחד או יותר.
שדות | |
---|---|
referencing_ |
פלט בלבד. הרשימה (ללא סדר וללא כפילויות) של כל מקורות הנתונים הראשיים שמקושרים למקור הנתונים הזה באמצעות כללי ברירת מחדל או כללים מותאמים אישית. לא ניתן למחוק מקור נתונים משלים לפני שמסירים את כל הקישורים. |
feed_ |
זה שינוי אופציונלי. לא ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים. המזהה צריך להכיל 20 תווים לכל היותר, שכוללים אותיות רישיות (A-Z), ספרות (0-9) ומקפים (-). מידע נוסף זמין במאמר מעבר לתוויות פיד. צריך להגדיר את הפרמטרים צריך להגדיר אותם למקורות נתונים באמצעות אם ההגדרה הזו מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם לא תגדירו את הערך, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
content_ |
זה שינוי אופציונלי. לא ניתן לשינוי. קוד השפה בן שתי האותיות לפי תקן ISO 639-1 של הפריטים במקור הנתונים. הערכים של אם ההגדרה הזו מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם לא תגדירו את הערך, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו. |
UpdateDataSourceRequest
הודעת הבקשה של שיטת UpdateDataSource.
שדות | |
---|---|
data_ |
חובה. המשאב של מקור הנתונים שרוצים לעדכן. |
update_ |
חובה. רשימת השדות של מקור הנתונים שרוצים לעדכן. שדות שצוינו במסכת העדכון ללא ערך שצוין בגוף יימחקו ממקור הנתונים. אין תמיכה במתן הערך המיוחד '*' להחלפה מלאה של מקור הנתונים. |