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 Overview.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

FileUploadsService

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

GetFileUpload

rpc GetFileUpload(GetFileUploadRequest) returns (FileUpload)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

CreateDataSourceRequest

הודעת הבקשה של שיטת 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

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

ProductReviewDataSource

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

MerchantReviewDataSource

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

קלט

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

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

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

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

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

DataSourceReference

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

שדות

שדה האיחוד data_source_id.

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

bool

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

string

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

string

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

DeleteDataSourceRequest

הודעת הבקשה של שיטת 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_uri. משמש לשליחת מקורות נתונים דרך SFTP.
password

string

אופציונלי. סיסמה אופציונלית ל-fetch_uri. משמש לשליחת מקורות נתונים דרך SFTP.

תדירות

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

string

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

int64

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

ProcessingState

פלט בלבד. מצב העיבוד של מקור הנתונים.
issues[]

Issue

פלט בלבד. רשימת הבעיות במקור הנתונים.
items_total

int64

פלט בלבד. מספר הפריטים במקור הנתונים שעברו עיבוד.
items_created

int64

פלט בלבד. מספר הפריטים שנוצרו במקור הנתונים.
items_updated

int64

פלט בלבד. מספר הפריטים במקור הנתונים שעודכנו.
upload_time

Timestamp

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

בעיה

שגיאה שמתרחשת במקור הנתונים, כמו 'מחיר לא חוקי'.

שדות
title

string

פלט בלבד. שם הבעיה, לדוגמה, 'הפריט גדול מדי'.
description

string

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

string

פלט בלבד. קוד השגיאה, לדוגמה, validation/invalid_value. הפונקציה מחזירה את הערך '?' אם הקוד לא ידוע.
count

int64

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

Severity

פלט בלבד. חומרת הבעיה.
documentation_uri

string

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

מידת החומרה

חומרת הבעיה.

טיפוסים בני מנייה (enum)
SEVERITY_UNSPECIFIED רמת החומרה לא צוינה.
WARNING הבעיה היא האזהרה.
ERROR הבעיה היא שגיאה.

ProcessingState

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

טיפוסים בני מנייה (enum)
PROCESSING_STATE_UNSPECIFIED לא צוין מצב העיבוד.
FAILED לא ניתן היה לעבד את מקור הנתונים או שכל הפריטים הכילו שגיאות.
IN_PROGRESS מקור הנתונים נמצא בעיבוד.
SUCCEEDED מקור הנתונים עובד בהצלחה, אבל יכול להיות שיהיו שגיאות בחלק מהפריטים.

GetDataSourceRequest

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

שדות
name

string

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

GetFileUploadRequest

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

שדות
name

string

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

ListDataSourcesRequest

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

שדות
parent

string

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

int32

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

string

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

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

ListDataSourcesResponse

הודעת התגובה של השיטה 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 בן שתי אותיות.

MerchantReviewDataSource

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

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

PrimaryProductDataSource

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

שדות
channel

Channel

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

string

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

DefaultRule

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

DefaultRule

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

שדות
take_from_data_sources[]

DataSourceReference

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

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

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

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

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

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

ProductReviewDataSource

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

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

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

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

שדות
referencing_primary_data_sources[]

DataSourceReference

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

string

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

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

מידע נוסף זמין במאמר העברה לתוויות פיד.

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

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

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

string

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

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

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

UpdateDataSourceRequest

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

שדות
data_source

DataSource

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

FieldMask

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

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

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