Package google.shopping.merchant.datasources.v1beta

אינדקס

DataSourcesService

שירות לניהול מקורות נתונים ראשיים, משלימים, מלאי ומקורות נתונים אחרים. מידע נוסף זמין במאמר העזרה של Merchant Center.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

יצירת ההגדרה החדשה של מקור הנתונים לחשבון הנתון.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

תמחק מקור נתונים מחשבון Merchant Center.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

מתבצע אחזור של הנתונים באופן מיידי (גם מחוץ לתזמון השליפה) במקור נתונים מחשבון Merchant Center. אם אתם צריכים לקרוא לשיטה הזו יותר מפעם ביום, תוכלו להשתמש בשירות 'מוצרים' כדי לעדכן את נתוני המוצרים שלכם. השיטה הזו פועלת רק במקורות נתונים שהוגדר בהם קלט של קובץ.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

CreateDataSourceRequest

הודעת בקשה ל-method של CreateDataSource.

שדות
parent

string

חובה. החשבון שבו ייווצר מקור הנתונים הזה. פורמט: accounts/{account}
data_source

DataSource

חובה. מקור הנתונים שצריך ליצור.

DataSource

מקור הנתונים של חשבון Merchant Center.

שדות
name

string

מזהה. שם מקור הנתונים. פורמט: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

פלט בלבד. מזהה מקור הנתונים
display_name

string

חובה. שם מקור הנתונים שמוצג בממשק המשתמש של Merchant Center.
input

Input

פלט בלבד. ההגדרה קובעת את סוג הקלט למקור הנתונים. ייתכן שחלק מההגדרות לא יפעלו, בהתאם לקלט. ניתן ליצור רק מקורות נתונים גנריים באמצעות ה-API.
file_input

FileInput

זה שינוי אופציונלי. נעשה שימוש בשדה רק כשהנתונים מנוהלים באמצעות קובץ.
שדה איחוד Type. סוג של מקור נתונים. Type יכול להיות רק אחת מהאפשרויות הבאות:
primary_product_data_source

PrimaryProductDataSource

חובה. מקור הנתונים הראשי למוצרים בחנויות מקומיות ומוצרים אונליין.
supplemental_product_data_source

SupplementalProductDataSource

חובה. מקור הנתונים המשלים למוצרים בחנויות מקומיות ומוצרים אונליין.
local_inventory_data_source

LocalInventoryDataSource

חובה. מקור הנתונים של מלאי בחנות מקומית.
regional_inventory_data_source

RegionalInventoryDataSource

חובה. מקור הנתונים של מלאי אזורי.
promotion_data_source

PromotionDataSource

חובה. מקור הנתונים של המבצע.

קלט

ההגדרה קובעת את סוג הקלט למקור הנתונים. בהתאם לקלט, יכול להיות שחלק מההגדרות לא נתמכות.

טיפוסים בני מנייה (enum)
INPUT_UNSPECIFIED לא צוין קלט.
API מייצג את מקורות הנתונים שעבורם רוב הנתונים סופקו דרך ה-API.
FILE מייצג מקורות נתונים שעבורם הנתונים סופקו בעיקר באמצעות קלט של קובץ. עדיין אפשר לספק את הנתונים באמצעות ה-API.
UI

מקור הנתונים של מוצרים שנוספו ישירות ב-Merchant Center.

אי אפשר ליצור או לעדכן מקור נתונים מהסוג הזה באמצעות ה-API הזה, אלא רק בממשק המשתמש של Merchant Center.

מקור נתונים מהסוג הזה הוא לקריאה בלבד.
AUTOFEED העדכונים האלה נקראים גם פידים אוטומטיים שמשמשים ליצירה אוטומטית של נתוני המוצרים. ניתן להפעיל או להשבית מקור נתונים מהסוג הזה באמצעות חבילת החשבונות.

DeleteDataSourceRequest

הודעת בקשה ל-method DeleteDataSource.

שדות
name

string

חובה. שם מקור הנתונים למחיקה. פורמט: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

הודעת בקשה לשיטת FetchDataSource.

שדות
name

string

חובה. שם המשאב של מקור הנתונים לאחזור. פורמט: accounts/{account}/dataSources/{datasource}

FileInput

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

שדות
fetch_settings

FetchSettings

זה שינוי אופציונלי. מאחזרים את הפרטים כדי להעביר את מקור הנתונים. הוא מכיל הגדרות עבור סוגי קלט של קבצים FETCH ו-GOOGLE_SHEETS. שדות החובה משתנים בהתאם לתדירות השליפה.
file_name

string

זה שינוי אופציונלי. שם הקובץ של מקור הנתונים. נדרש עבור סוג קלט של קובץ UPLOAD.
file_input_type

FileInputType

פלט בלבד. סוג הקלט של הקובץ.

FetchSettings

מאחזרים את הפרטים כדי להעביר את מקור הנתונים.

שדות
enabled

bool

זה שינוי אופציונלי. המתג מפעיל או משהה את תזמון השליפה.
day_of_month

int32

זה שינוי אופציונלי. היום בחודש שבו צריך לאחזר את הקובץ של מקור הנתונים (1 עד 31). ניתן להגדיר את השדה הזה לתדירות חודשית בלבד.
time_of_day

TimeOfDay

זה שינוי אופציונלי. השעה ביום שבה יש לאחזר את קובץ מקור הנתונים. דקות ושניות לא נתמכות והמערכת תתעלם מהן.
day_of_week

DayOfWeek

זה שינוי אופציונלי. היום בשבוע שבו יש לאחזר את קובץ מקור הנתונים. ניתן להגדיר את השדה הזה רק לתדירות שבועית.
time_zone

string

זה שינוי אופציונלי. אזור הזמן שמוגדר ללוח הזמנים. לפי שעון UTC כברירת מחדל. לדוגמה, "America/Los_Angeles".
frequency

Frequency

חובה. התדירות שמתארת את לוח הזמנים לשליפה.
fetch_uri

string

זה שינוי אופציונלי. כתובת ה-URL שאליה ניתן לאחזר את קובץ מקור הנתונים. מערכת Google Merchant Center תומכת בהעלאות מתוזמנות אוטומטיות באמצעות הפרוטוקולים HTTP, HTTPS או SFTP, ולכן הערך צריך להיות קישור תקין שמשתמש באחד משלושת הפרוטוקולים האלה. לא ניתן לשינוי בקובצי Google Sheets.
username

string

זה שינוי אופציונלי. שם משתמש אופציונלי ל[fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. משמש לשליחת מקורות נתונים באמצעות SFTP.
password

string

זה שינוי אופציונלי. סיסמה אופציונלית ל[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

string

חובה. שם מקור הנתונים שצריך לאחזר. פורמט: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

הודעת בקשה ל-method ListDataSources.

שדות
parent

string

חובה. החשבון שעבורו יש להציג רשימה של מקורות נתונים. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של מקורות נתונים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יועברו ל-1,000. אם לא צוין, המערכת תחזיר את המספר המקסימלי של מקורות נתונים.
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-ListDataSources. צריך לספק אותה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-ListDataSources חייבים להתאים לקריאה שסיפקה את אסימון הדף.

ListDataSourcesResponse

הודעת תגובה ל-method ListDataSources.

שדות
data_sources[]

DataSource

מקורות הנתונים מהחשבון שצוין.
next_page_token

string

אסימון, שניתן לשלוח בתור page_token כדי לאחזר את הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

LocalInventoryDataSource

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

שדות
feed_label

string

חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם צוין המלאי בחנות המקומית.

חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-).

למידע נוסף, ראו מעבר לתוויות פיד.
content_language

string

חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם נשלח המלאי בחנות המקומית.

PrimaryProductDataSource

מקור הנתונים הראשי למוצרים בחנויות מקומיות ואונליין.

שדות
channel

Channel

חובה. בלתי ניתן לשינוי. מציין את סוג הערוץ של מקור נתונים.
countries[]

string

זה שינוי אופציונלי. המדינות שבהן הפריטים יכולים להופיע. מיוצג כקוד של אזור CLDR.
feed_label

string

זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים.

חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-).

למידע נוסף, ראו מעבר לתוויות פיד.

צריך להגדיר או להגדיר גם את המדיניות feedLabel וגם את הערך contentLanguage עבור מקורות נתונים עם סוג תוכן של מוצר. צריך להגדיר אותם למקורות נתונים עם קלט של קובץ.

אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו.
content_language

string

זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1.

צריך להגדיר את feedLabel ואת הערך contentLanguage או להגדיר אותן. אפשר לבטל את ההגדרה של השדות רק במקורות נתונים שאין בהם קלט של קובץ.

אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו.

ערוץ

ערוץ מקור הנתונים.

הערוץ משמש להבחנה בין מקורות נתונים לענפים שונים של מוצרים.

טיפוסים בני מנייה (enum)
CHANNEL_UNSPECIFIED לא צוין.
ONLINE_PRODUCTS מוצר אונליין.
LOCAL_PRODUCTS מוצר בחנות מקומית.
PRODUCTS מקור נתונים מאוחד למוצרים מקומיים ולמוצרים אונליין.

PromotionDataSource

מקור הנתונים של המבצע.

שדות
target_country

string

חובה. בלתי ניתן לשינוי. מדינת היעד שמשמשת כחלק מהמזהה הייחודי. מיוצג כקוד של אזור CLDR.

מבצעים זמינים רק במדינות מסוימות.
content_language

string

חובה. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1.

RegionalInventoryDataSource

מקור נתוני המלאי האזורי.

שדות
feed_label

string

חובה. בלתי ניתן לשינוי. תווית הפיד של המוצרים שאליהם סופק המלאי האזורי.

חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-).

למידע נוסף, ראו מעבר לתוויות פיד.
content_language

string

חובה. בלתי ניתן לשינוי. שתי אותיות לפי תקן ISO 639-1 של הפריטים שאליהם מסופק המלאי האזורי.

SupplementalProductDataSource

מקור הנתונים המשלים למוצרים בחנויות מקומיות ואונליין.

שדות
feed_label

string

זה שינוי אופציונלי. בלתי ניתן לשינוי. תווית הפיד שצוינה ברמת מקור הנתונים.

חייב להיות באורך של עד 20 אותיות גדולות (A-Z), מספרים (0-9) ומקפים (-).

למידע נוסף, ראו מעבר לתוויות פיד.

צריך להגדיר או להגדיר גם את המדיניות feedLabel וגם את הערך contentLanguage עבור מקורות נתונים עם סוג תוכן של מוצר. צריך להגדיר אותם למקורות נתונים עם קלט של קובץ.

אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו.
content_language

string

זה שינוי אופציונלי. בלתי ניתן לשינוי. שפת הפריטים במקור הנתונים לפי תקן ISO 639-1.

צריך להגדיר את feedLabel ואת הערך contentLanguage או להגדיר אותן. אפשר לבטל את ההגדרה של השדות רק במקורות נתונים שאין בהם קלט של קובץ.

אם היא מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם המדיניות לא מוגדרת, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו.

UpdateDataSourceRequest

הודעת בקשה ל-method של UpdateDataSource.

שדות
data_source

DataSource

חובה. המשאב של מקור הנתונים שצריך לעדכן.
update_mask

FieldMask

חובה. רשימת השדות של מקור הנתונים שיש לעדכן.

שדות שצוינו במסכת העדכון ללא ערך שצוין בגוף הנתונים יימחקו ממקור הנתונים.

אי אפשר לציין ערך "*" מיוחד להחלפה מלאה של מקור הנתונים.