REST Resource: accounts.dataSources

משאב: מקור נתונים

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

ייצוג JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
שדות
name

string

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

string (int64 format)

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

string

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

enum (Input)

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

object (FileInput)

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

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

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

object (RegionalInventoryDataSource)

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

object (PromotionDataSource)

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

PrimaryProductDataSource

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

ייצוג JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
שדות
channel

enum (Channel)

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

string

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

string

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

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

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

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

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

string

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

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

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

ערוץ

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

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

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

SupplementalProductDataSource

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

ייצוג JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
שדות
feedLabel

string

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

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

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

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

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

string

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

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

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

LocalInventoryDataSource

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

ייצוג JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
שדות
feedLabel

string

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

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

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

string

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

RegionalInventoryDataSource

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

ייצוג JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
שדות
feedLabel

string

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

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

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

string

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

PromotionDataSource

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

ייצוג JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
שדות
targetCountry

string

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

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

string

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

קלט

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

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

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

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

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

FileInput

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

ייצוג JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
שדות
fetchSettings

object (FetchSettings)

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

string

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

enum (FileInputType)

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

FetchSettings

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

ייצוג JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
שדות
enabled

boolean

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

integer

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

string

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

enum (Frequency)

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

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.

TimeOfDay

מייצג שעה ביום. התאריך ואזור הזמן לא משמעותיים או שהם מצוינים במקום אחר. יכול להיות ש-API יבחר לאפשר שניות מדלגות. הסוגים הקשורים הם google.type.Date ו-google.protobuf.Timestamp.

ייצוג JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
שדות
hours

integer

שעות ביום בפורמט 24 שעות. צריך להיות מספר בין 0 ל-23. אתם יכולים להשתמש ב-API כדי לאשר את הערך '24:00:00' בתרחישים כמו שעת הסגירה של העסק.
minutes

integer

דקות בשעה ביום. חייב להיות בין 0 ל-59.
seconds

integer

שניות של זמן. בדרך כלל הערך צריך להיות בין 0 ל-59. ה-API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות מדלגות.
nanos

integer

שברי שניות בננו-שניות. חייב להיות בין 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].

שיטות

create

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

delete

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

fetch

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

get

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

list

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

patch

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