REST Resource: accounts.dataSources

משאב: DataSource

מקור הנתונים של חשבון 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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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)

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

object (ProductReviewDataSource)

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

object (MerchantReviewDataSource)

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

PrimaryProductDataSource

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

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

enum (Channel)

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

string

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

object (DefaultRule)

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

string

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

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

אפשר לעיין גם במאמר מעבר לתוויות פיד.

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

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

string

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

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

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

ערוץ

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

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

טיפוסים בני מנייה (enum)
CHANNEL_UNSPECIFIED לא צוין.
ONLINE_PRODUCTS מוצר אונליין.
LOCAL_PRODUCTS מוצר בחנות מקומית.
PRODUCTS מקור נתונים מאוחד למוצרים בחנויות מקומיות ולמוצרים באינטרנט. הערה: אי אפשר לנהל את המוצרים דרך ה-API בערוץ הזה.

DefaultRule

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

ייצוג ב-JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
שדות
takeFromDataSources[]

object (DataSourceReference)

חובה. רשימת מקורות הנתונים שמקושרים בכלל ברירת המחדל. הרשימה הזו ממוינת לפי עדיפות ברירת המחדל של הכלל שבו נעשה שימוש כדי למזג את הנתונים. יכול להיות שהיא לא תכלול אף הפניה ל-self ולמקורות נתונים משלימים, או שתכלול כמה הפניות כאלה.

הרשימה לא יכולה להיות ריקה.

כדי לקשר את מקור הנתונים לכלל ברירת המחדל, צריך להוסיף לרשימה הזו הפניה חדשה (בסדר כרונולוגי).

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

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

לדוגמה, אם תספקו את הרשימה הבאה: [1001, self], מערכת Google Ads תשתמש בערכים של המאפיינים ממקור הנתונים המשלים 1001, ותעבור ל-self אם המאפיין לא מוגדר ב-1001.

DataSourceReference

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

ייצוג ב-JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
שדות

שדה האיחוד data_source_id.

הערך של data_source_id יכול להיות רק אחת מהאפשרויות הבאות:
self

boolean

צריך להשתמש ב-Self כדי להפנות למקור הנתונים הראשי עצמו.
primaryDataSourceName

string

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

string

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

SupplementalProductDataSource

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

ייצוג ב-JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
שדות
referencingPrimaryDataSources[]

object (DataSourceReference)

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

string

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

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

אפשר לעיין גם במאמר מעבר לתוויות פיד.

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

צריך להגדיר אותם למקורות נתונים עם file input. צריך לבטל את ההגדרה של השדות במקורות נתונים ללא file input.

אם ההגדרה הזו מוגדרת, מקור הנתונים יקבל רק מוצרים שתואמים לשילוב הזה. אם לא תגדירו את הערך, מקור הנתונים יקבל מוצרים ללא ההגבלה הזו.
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 של הפריטים במקור הנתונים.

ProductReviewDataSource

אין שדות לסוג הזה.

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

MerchantReviewDataSource

אין שדות לסוג הזה.

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

קלט

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

טיפוסים בני מנייה (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

אופציונלי. שם משתמש אופציונלי ל-fetchUri. משמש לשליחת מקורות נתונים דרך SFTP.
password

string

אופציונלי. סיסמה אופציונלית ל-fetchUri. משמש לשליחת מקורות נתונים דרך 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 ראשון

תדירות

השדות הנדרשים משתנים בהתאם לתדירות האחזור. בלוח זמנים חודשי לאחזור, צריך לציין את הערכים של [יום בחודש][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 הקובץ מאוחזר מה-fetchUri שהוגדר.
GOOGLE_SHEETS הקובץ מאוחזר מ-Google Sheets שצוין ב-fetchUri.

Methods

create

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

delete

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

fetch

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

get

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

list

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

patch

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