אינדקס
ProductInputsService
(ממשק)ProductsService
(ממשק)Attributes
(הודעה)Certification
(הודעה)CloudExportAdditionalProperties
(הודעה)DeleteProductInputRequest
(הודעה)FreeShippingThreshold
(הודעה)GetProductRequest
(הודעה)InsertProductInputRequest
(הודעה)Installment
(הודעה)ListProductsRequest
(הודעה)ListProductsResponse
(הודעה)LoyaltyPoints
(הודעה)LoyaltyProgram
(הודעה)Product
(הודעה)ProductDetail
(הודעה)ProductDimension
(הודעה)ProductInput
(הודעה)ProductStatus
(הודעה)ProductStatus.DestinationStatus
(הודעה)ProductStatus.ItemLevelIssue
(הודעה)ProductStatus.ItemLevelIssue.Severity
(טיפוס enum)ProductStructuredDescription
(הודעה)ProductStructuredTitle
(הודעה)ProductWeight
(הודעה)Shipping
(הודעה)ShippingDimension
(הודעה)ShippingWeight
(הודעה)SubscriptionCost
(הודעה)SubscriptionPeriod
(טיפוס טיפוסים בני מנייה (enum))Tax
(הודעה)UnitPricingBaseMeasure
(הודעה)UnitPricingMeasure
(הודעה)
ProductInputsService
שירות לשימוש במשאב ProductInput. השירות הזה פועל רק לגבי מוצרים עם ערוץ אונליין.
DeleteProductInput |
---|
מחיקת קלט של מוצר מחשבון Merchant Center שלכם. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד.
|
InsertProductInput |
---|
מעלה קלט של מוצר לחשבון Merchant Center. אם כבר קיים קלט עם אותם ערכים ב-contentLanguage, ב-offerId וב-dataSource, השיטה הזו תחליף את הרשומה הזו. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד.
|
ProductsService
שירות לשימוש במשאב המוצר. השירות הזה פועל רק לגבי מוצרים עם ערוץ אונליין.
GetProduct |
---|
אחזור המוצר המעובד מחשבון Merchant Center שלך. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיעברו כמה דקות עד שאפשר יהיה לאחזר את המוצר הסופי המעודכן.
|
ListProducts |
---|
בתיבת הדו-שיח הזו מפורטים המוצרים המעובדים בחשבון Merchant Center שלכם. התגובה עשויה להכיל פחות פריטים ממה שצוין לפי pageSize. מסתמכים על pageToken כדי לקבוע אם יש פריטים נוספים שצריך לבקש. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיעברו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן.
|
מאפיינים
מאפיינים.
שדות | |
---|---|
additional_image_links[] |
כתובות URL נוספות של תמונות של הפריט. |
expiration_date |
התאריך שבו הפריט יפוג, כפי שצוין בזמן ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל ייחשף ב- |
disclosure_date |
התאריך שבו מוצר מופיע בתוצאות חיפוש בפלטפורמות YouTube של Google, בפורמט ISO 8601. מידע נוסף זמין בקטע [תאריך החשיפה]( https://support.google.com/merchants/answer/13034208). |
availability_date |
ביום שבו מוצר שמוזמן מראש יהיה זמין למשלוח, בפורמט ISO 8601. |
price |
מחיר הפריט. |
installment |
מספר התשלומים על פריט וסכום התשלומים. |
subscription_cost |
מספר התקופות (חודשים או שנים) וסכום התשלום לכל תקופה עבור פריט עם חוזה מינוי משויך. |
loyalty_points |
נקודות מועדון שמשתמשים מקבלים אחרי רכישת הפריט. ביפן בלבד. |
loyalty_programs[] |
רשימה של מידע על מועדון הלקוחות שמשמשת כדי להציג למשתמשים של הפריט הזה הטבות לחברי מועדון (למשל, מחירים טובים יותר, נקודות וכו'). |
product_types[] |
קטגוריות הפריט (בפורמט של מפרט נתוני המוצרים). |
sale_price |
מחיר המבצע שפורסם על הפריט. |
sale_price_effective_date |
טווח התאריכים שבו הפריט נמכר במחיר מבצע (מידע נוסף זמין במפרט נתוני המוצרים). |
product_height |
גובה המוצר ביחידות שסופקו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל). |
product_length |
אורך המוצר ביחידות שסופקו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל). |
product_width |
רוחב המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל). |
product_weight |
משקל המוצר ביחידות שסופקו. הערך חייב להיות בין 0 (לא כולל) ל-2,000 (כולל). |
shipping[] |
כללי משלוח. |
free_shipping_threshold[] |
התנאים שצריך לעמוד בהם כדי שמוצר מסוים יקבל משלוח חינם. |
shipping_weight |
משקל הפריט למשלוח. |
shipping_length |
אורך הפריט למשלוח. |
shipping_width |
רוחב הפריט במשלוח. |
shipping_height |
גובה הפריט למשלוח. |
size_types[] |
הגזרה של הפריט. אפשר להשתמש בו כדי לייצג סוגי מידות משולבים לפריטי לבוש. אפשר לציין שני סוגי מידות לכל היותר (מידע נוסף זמין בכתובת [https://support.google.com/merchants/answer/6324497](size type)). |
taxes[] |
פרטי המס. |
unit_pricing_measure |
הממדים, הנפח או המשקל ויחידת המידה של פריט. |
unit_pricing_base_measure |
העדפה של המכנה של המחיר ליחידה. |
ads_labels[] |
דומה למאפיין ads_grouping, אבל הוא פועל רק לפי עלות לקליק (CPC). |
cost_of_goods_sold |
עלות המכר. משמש לדיווח על רווח ברוטו. |
product_details[] |
מפרט טכני או פרטים נוספים על המוצר. |
product_highlights[] |
נקודות בולטות שמתארות את הפרטים החשובים ביותר של המוצר. |
display_ads_similar_ids[] |
המלצות שצוינו על ידי המפרסם. |
promotion_ids[] |
המזהה הייחודי של מבצע. |
included_destinations[] |
רשימת היעדים שצריך לכלול בשביל היעד הזה (הרשימה תואמת לתיבות שמסומנות ב-Merchant Center). יעדי ברירת מחדל תמיד נכללים, אלא אם צוינו ב- |
excluded_destinations[] |
רשימת היעדים שצריך להחריג בשביל היעד הזה (הרשימה תואמת לתיבות שלא מסומנות ב-Merchant Center). |
shopping_ads_excluded_countries[] |
רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם מצוין המוצר להחרגה מהיעד של מודעות שופינג. מדינות מהרשימה הזו יוסרו ממדינות שהוגדרו בהגדרות של מקור הנתונים. |
lifestyle_image_links[] |
כתובות URL נוספות של תמונות סגנון חיים של הפריט, שמשמשות לזיהוי מפורש של תמונות שמציגות את הפריט בהקשר שממחיש את השימוש בו בעולם האמיתי. מידע נוסף זמין במאמר הזה במרכז העזרה. |
cloud_export_additional_properties[] |
שדות נוספים לייצוא לתוכנית Cloud Retail. |
certifications[] |
אישורי מוצרים, לדוגמה, לתיוג יעילות אנרגטית של מוצרים שתועדו במסד הנתונים של ה-EPREL באיחוד האירופי. מידע נוסף זמין במאמר במרכז העזרה. |
auto_pricing_min_price |
אמצעי הגנה ב'הנחות אוטומטיות' (https://support.google.com/merchants/answer/10295759) ו'קידומי מכירות דינמיים' (https://support.google.com/merchants/answer/13949249), כדי להבטיח שהמוכרים יקבלו הנחות המוצרים לא יורדים מתחת לערך הזה, וכך שומרים על הערך והרווחיות של המוצר. |
identifier_exists |
יש להגדיר את הערך הזה כ-False אם לפריט אין מזהי מוצר ייחודיים (UPI) שמתאימים לקטגוריה שלו, כמו מספר פריט מסחרי גלובלי (GTIN), קוד MPN ומותג. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא True. |
is_bundle |
האם הפריט הוא חבילה שהמוכר מגדיר. חבילה מורכבת מקבוצה מותאמת אישית של מוצרים שונים שנמכרים על ידי מוכר במחיר כולל. |
title |
שם הפריט. |
description |
תיאור הפריט. |
link |
כתובת URL שמקשרת ישירות לדף הפריט בחנות הווירטואלית. |
mobile_link |
כתובת ה-URL של דף הנחיתה של הפריט בגרסה שמותאמת לניידים. |
canonical_link |
כתובת ה-URL של הגרסה הקנונית של דף הנחיתה של הפריט. |
image_link |
כתובת ה-URL של תמונת הפריט. |
adult |
צריך להגדיר את הערך True אם הפריט מטורגט למבוגרים. |
age_group |
מטרגטים את קבוצת הגיל של הפריט. |
availability |
סטטוס הזמינות של הפריט. |
brand |
המותג של הפריט |
color |
צבע הפריט. |
condition |
מצב הפריט. |
gender |
מגדר היעד של הפריט. |
google_product_category |
הקטגוריה של הפריט ב-Google (מידע נוסף זמין בטקסונומיית המוצרים של Google). כששולחים שאילתות על מוצרים, השדה הזה יכיל את הערך שסופק על ידי המשתמש. בשלב הזה אין דרך לקבל בחזרה את קטגוריות המוצרים ב-Google שהוקצו באופן אוטומטי דרך ה-API. |
gtin |
מספר הפריט המסחרי הגלובלי (GTIN) של הפריט. |
item_group_id |
מזהה משותף לכל הווריאציות של אותו מוצר. |
material |
החומר שממנו עשוי הפריט. |
mpn |
מספר החלק שהיצרן הקצה לפריט (MPN). |
pattern |
דוגמת העיצוב של הפריט (לדוגמה, נקודות). |
sell_on_google_quantity |
כמות המוצרים שזמינים למכירה ב-Google. נתמך רק במוצרים שנמכרים אונליין. |
max_handling_time |
זמן טיפול מקסימלי במוצר (בימי עסקים). |
min_handling_time |
זמן טיפול מינימלי במוצר (בימי עסקים). |
shipping_label |
תווית המשלוח של המוצר, שמשמשת לקיבוץ המוצר בכללי משלוח ברמת החשבון. |
transit_time_label |
תווית זמן ההובלה של המוצר, שמשמשת לקיבוץ המוצר בטבלאות זמן הובלה ברמת החשבון. |
size |
גודל הפריט. מותר להשתמש בערך אחד בלבד. לווריאציות במידות שונות, צריך להזין מוצר נפרד לכל מידה עם אותו ערך |
size_system |
מערכת שבה הגודל שצוין. מומלץ לפריטי לבוש. |
tax_category |
קטגוריית המס של המוצר, שמשמשת לקביעת נגיעות מס מפורטות בהגדרות המס ברמת החשבון. |
energy_efficiency_class |
סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי. |
min_energy_efficiency_class |
סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי. |
max_energy_efficiency_class |
סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי. |
multipack |
מספר המוצרים הזהים במארז של כמה יחידות, לפי הגדרת המוכר. |
ads_grouping |
משמש לקיבוץ פריטים באופן שרירותי. רק עבור אחוז מהמחיר להמרה, לא מומלץ אחרת. |
ads_redirect |
השיטה מאפשרת למפרסמים לשנות את כתובת ה-URL של הפריט כשהמוצר מוצג בהקשר של מודעות למוצר. |
display_ads_id |
מזהה של פריט לקמפיינים של רימרקטינג דינמי. |
display_ads_title |
שם הפריט בקמפיינים של רימרקטינג דינמי. |
display_ads_link |
כתובת URL שמובילה ישירות אל דף הנחיתה של הפריט ומיועדת לקמפיינים של רימרקטינג דינמי. |
display_ads_value |
שולי הרווח בקמפיינים של רימרקטינג דינמי. |
pickup_method |
אפשרות האיסוף של הפריט. |
pickup_sla |
ציר הזמן לאיסוף הפריט מהחנות. |
link_template |
תבנית קישור לדף של חנות מקומית באתר של המוכר. |
mobile_link_template |
תבנית קישור לדף של חנות מקומית באתר של המוכר שמותאם לניידים. |
custom_label_0 |
תווית מותאמת אישית 0 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג. |
custom_label_1 |
תווית מותאמת אישית 1 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג. |
custom_label_2 |
תווית מותאמת אישית 2 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג. |
custom_label_3 |
תווית מותאמת אישית 3 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג. |
custom_label_4 |
תווית מותאמת אישית 4 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג. |
external_seller_id |
חובה בחשבונות עם כמה אתרי מכירה. המאפיין הזה מתאים אם אתם מנהלים זירת מסחר שמעלה מוצרים של אתרי מכירה שונים לחשבון שלכם שמוגדרים בו כמה אתרי מכירה. |
pause |
פרסום הפריט הזה יושהה באופן זמני. |
virtual_model_link |
כתובת ה-URL של תמונת הפריט בתלת-ממד. מידע נוסף זמין במאמר הזה במרכז העזרה. |
structured_title |
שם פריט מובנה, לשמות פריטים שנוצרו על ידי אלגוריתם (AI). |
structured_description |
תיאור מובנה, לתיאורים שנוצרו באמצעות אלגוריתם (AI). |
הסמכה
אישור מוצר, שנוסף לראשונה כדי לעמוד בדרישות של האיחוד האירופי לסימון יעילות אנרגטית באמצעות מסד הנתונים של ה-EPREL באיחוד האירופי.
שדות | |
---|---|
certification_authority |
רשות האישורים, לדוגמה European_Commission. האורך המרבי הוא 2,000 תווים. |
certification_name |
שם האישור, לדוגמה EPREL. האורך המרבי הוא 2,000 תווים. |
certification_code |
קוד האישור. האורך המרבי הוא 2,000 תווים. |
certification_value |
ערך האישור (שנקרא גם class, רמה או ציון), למשל A+ , C, gold. האורך המרבי הוא 2,000 תווים. |
CloudExportAdditionalProperties
מאפיין מוצר ל-Cloud Retail API. לדוגמה, מאפיינים של מוצר טלוויזיה יכולים להיות 'רזולוציית מסך' או 'גודל מסך'.
שדות | |
---|---|
text_value[] |
ערך הטקסט של המאפיין הנתון. לדוגמה, "8K(UHD)" הוא יכול להיות ערך טקסט של מוצר טלוויזיה. מספר החזרות המקסימלי של הערך הזה הוא 400. הערכים מאוחסנים בסדר שרירותי ועקבי. גודל המחרוזת המקסימלי הוא 256 תווים. |
int_value[] |
ערכי מספר שלם של המאפיין הנתון. לדוגמה: 1080 לרזולוציית מסך של מוצר טלוויזיה. מספר החזרות המקסימלי של הערך הזה הוא 400. הערכים מאוחסנים בסדר שרירותי ועקבי. |
float_value[] |
ערכים צפים של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 1.2345. מספר החזרות המקסימלי של הערך הזה הוא 400. הערכים מאוחסנים בסדר שרירותי ועקבי. |
property_name |
שם המאפיין הנתון. לדוגמה, "רזולוציית מסך" למוצר טלוויזיה. גודל המחרוזת המקסימלי הוא 256 תווים. |
bool_value |
ערך בוליאני של הנכס הנתון. לדוגמה עבור מוצר טלוויזיה, "True" או 'False' אם המסך הוא באיכות UHD. |
min_value |
הערך המינימלי של מספר ממשי (float) של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 1.00. |
max_value |
הערך המקסימלי של מספר ממשי (float) של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 100.00. |
unit_code |
יחידה של המאפיין הנתון. לדוגמה, "Pixels" למוצר טלוויזיה. גודל המחרוזת המקסימלי הוא 256B. |
DeleteProductInputRequest
יש לבקש הודעה עבור המתודה DeleteProductInput.
שדות | |
---|---|
name |
חובה. שם המשאב של קלט המוצר למחיקה. פורמט: accounts/{account}/productInputs/{product} |
data_source |
חובה. מקור הנתונים הראשי או המשלים שממנו צריך למחוק את קלט המוצר. פורמט: |
FreeShippingThreshold
התנאים שצריך לעמוד בהם כדי שמוצר מסוים יקבל משלוח חינם.
שדות | |
---|---|
country |
קוד האזור במאגר CLDR של המדינה שאליה הפריט יישלח. |
price_threshold |
מחיר המוצר המינימלי שעלות המשלוח תהיה בחינם. מיוצג כמספר. |
GetProductRequest
הודעת בקשה לשיטת GetProduct.
שדות | |
---|---|
name |
חובה. שם המוצר לאחזור. פורמט: |
InsertProductInputRequest
יש לבקש הודעה עבור שיטת InsertProductInput.
שדות | |
---|---|
parent |
חובה. החשבון שאליו יתווסף המוצר הזה. פורמט: accounts/{account} |
product_input |
חובה. קלט המוצר שיש להוסיף. |
data_source |
חובה. שם המקור הראשי או המשלים של נתוני המוצרים. אם המוצר כבר קיים ומקור הנתונים שסופק שונה, המוצר יועבר למקור נתונים חדש. פורמט: |
תשלומים
הודעה שמייצגת תשלומים.
שדות | |
---|---|
months |
מספר התשלומים שהקונה צריך לשלם. |
amount |
הסכום שהקונה צריך לשלם בכל חודש. |
downpayment |
סכום המקדמה שהקונה צריך לשלם. |
credit_type |
סוג התשלומים. הערכים הנתמכים הם: * " |
ListProductsRequest
בקשת הודעה ל-method ListProducts.
שדות | |
---|---|
parent |
חובה. החשבון שלגביו רוצים להציג מוצרים מעובדים. פורמט: accounts/{account} |
page_size |
המספר המקסימלי של מוצרים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000; ערכים מעל 1000 יקובצו ל-1000. אם לא מציינים זאת, המערכת תחזיר את מספר המוצרים המקסימלי. |
page_token |
אסימון דף, שהתקבל מקריאה קודמת ב- במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל- |
ListProductsResponse
הודעת תשובה לשיטת ListProducts.
שדות | |
---|---|
products[] |
המוצרים המעובדים מהחשבון שצוין. אלה המוצרים המעובדים אחרי החלה של כללים ומקורות נתונים משלימים. |
next_page_token |
אסימון, שניתן לשלוח בתור |
LoyaltyPoints
מסר שמייצג נקודות מועדון.
שדות | |
---|---|
name |
השם של תוכנית נקודות המועדון. מומלץ להגביל את השם ל-12 תווים ברוחב מלא או ל-24 תווים לטיניים. |
points_value |
נקודות המועדון של הקמעונאי בערך מוחלט. |
ratio |
היחס של נקודה כשממירים אותה למטבע. Google מניחה שמטבע זה נקבע על סמך ההגדרות ב-Merchant Center. אם לא מזינים את היחס, ברירת המחדל תהיה 1.0. |
LoyaltyProgram
הודעה שמייצגת מועדון לקוחות.
שדות | |
---|---|
program_label |
התווית של מועדון הלקוחות. זוהי תווית פנימית שמזהה באופן ייחודי את הקשר בין ישות של מוכר לבין ישות של מועדון לקוחות. צריך לספק את התווית כדי שהמערכת תוכל לשייך למוכר את הנכסים שמפורטים בהמשך (לדוגמה, מחיר ונקודות). התוכנית המתאימה חייבת להיות מקושרת לחשבון המוכר. |
tier_label |
התווית של הרמה במועדון הלקוחות. חייבת להתאים לאחת מהתוויות בתוכנית. |
price |
המחיר למנויים ברמה הנתונה, כלומר מחיר ההנחה המיידי. הערך חייב להיות קטן מהמחיר הרגיל או שווה לו. |
cashback_for_future_use |
הקאשבק (cashback) שניתן להשתמש בו לרכישות עתידיות. |
loyalty_points |
סכום נקודות המועדון שנצברות ברכישה. |
member_price_effective_date |
טווח תאריכים שבמהלכו הפריט עומד בדרישות למחיר לחברי מועדון. אם לא מציינים זאת, המחיר לחברי מועדון תמיד יהיה תקף. טווח התאריכים מיוצג על ידי צמד תאריכים בפורמט ISO 8601 שמופרדים באמצעות רווח, פסיק או קו נטוי. |
מוצר
המוצר המעובד, שנוצר מכמה [אמצעי קלט של מוצרים][[google.shopping.content.bundles.Products.ProductInput], לאחר החלת כללים ומקורות נתונים משלימים. המוצר המעובד הזה תואם למידע שמוצג בחשבון Merchant Center, במודעות שופינג ובפלטפורמות אחרות ב-Google. כל מוצר נוצר מפרטים של מקור נתונים ראשי אחד בלבד, מכמה מקורות נתונים משלימים. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיעברו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן.
כל השדות במוצר המעובד ובהודעות המשנה שלו תואמים לשם המאפיין התואם במפרט נתוני המוצרים, למעט כמה יוצאים מן הכלל.
שדות | |
---|---|
name |
שם המוצר. פורמט: |
channel |
פלט בלבד. הערוץ של המוצר. |
offer_id |
פלט בלבד. המזהה הייחודי של המוצר. הערך הזה חל גם על המוצר שהוזן על ידי המוצר וגם לגבי המוצר שעבר עיבוד. המערכת מסירה רווחים לבנים בתחילת הטקסט ובסופו, ורווחים מרובים מוחלפים ברווח לבן אחד מיד לאחר השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים. |
content_language |
פלט בלבד. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של המוצר. |
feed_label |
פלט בלבד. תווית הפיד של המוצר. |
data_source |
פלט בלבד. מקור הנתונים הראשי של המוצר. |
attributes |
פלט בלבד. רשימה של מאפייני מוצרים. |
custom_attributes[] |
פלט בלבד. רשימה של מאפיינים מותאמים אישית (שהמוכר סיפק). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הנתונים בגרסה הכללית (לדוגמה, |
product_status |
פלט בלבד. הסטטוס של מוצר, בעיות באימות הנתונים, כלומר מידע על מוצר שמחושב באופן אסינכרוני. |
version_number |
פלט בלבד. מייצג את הגרסה הקיימת (עדכניות) של המוצר, ואפשר להשתמש בה כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אם המדיניות מוגדרת, המערכת מונעת את ההוספה של פריטים כשמספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון של המוצר אחרי 30 ימים) עם הערך הנוכחי של האפשרות הזו נתמכת רק עבור הכנסות למקורות נתונים ראשיים. אם הפעולה נמנעת, המערכת תבטל את החריגה שבוטלה. |
ProductDetail
פרטי המוצר.
שדות | |
---|---|
section_name |
כותרת הקטע שמשמשת לקיבוץ של קבוצת פרטי מוצר. |
attribute_name |
השם של פרטי המוצר. |
attribute_value |
הערך של פרטי המוצר. |
ProductDimension
המאפיין של המוצר.
שדות | |
---|---|
value |
חובה. ערך המאפיין שמיוצג כמספר. הערך יכול להיות מדויק עד ארבע ספרות אחרי הנקודה העשרונית. |
unit |
חובה. יחידות המאפיינים. הערכים הקבילים הם: * " |
ProductInput
משאב זה מייצג נתוני קלט שאתם שולחים לגבי מוצר, ולא לגבי המוצר המעובד שמופיע ב-Merchant Center, במודעות שופינג או בפלטפורמות השונות של Google. המערכת משלבת קלט של מוצרים, כללים ונתוני מקור נתונים משלימים כדי ליצור את המוצר [product][google.shopping.content.bundles.Products.Product].
מאפייני הקלט של המוצרים שחובה לעבור כדי לעבור בדיקות אימות נתונים מוגדרים בעיקר במפרט נתוני המוצרים.
חובה לציין את המאפיינים הבאים: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] ו-[offerId][google.shopping.content.bundles.Products.offer_id].
אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד.
כל השדות בקלט המוצר ובהודעות המשנה שלו תואמים לשם באנגלית של המאפיין התואם במפרט התעשייה, למעט כמה יוצאים מן הכלל.
שדות | |
---|---|
name |
מזהה. השם של קלט המוצר. פורמט: |
product |
פלט בלבד. שם המוצר המעובד. פורמט: |
channel |
חובה. בלתי ניתן לשינוי. הערוץ של המוצר. |
offer_id |
חובה. בלתי ניתן לשינוי. המזהה הייחודי של המוצר. הערך הזה חל גם על המוצר שהוזן על ידי המוצר וגם לגבי המוצר שעבר עיבוד. המערכת מסירה רווחים לבנים בתחילת הטקסט ובסופו, ורווחים מרובים מוחלפים ברווח לבן אחד מיד לאחר השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים. |
content_language |
חובה. בלתי ניתן לשינוי. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של המוצר. |
feed_label |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצר. |
attributes |
זה שינוי אופציונלי. רשימה של מאפייני מוצרים. |
custom_attributes[] |
זה שינוי אופציונלי. רשימה של מאפיינים מותאמים אישית (שהמוכר סיפק). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הנתונים בגרסה הכללית (לדוגמה, |
version_number |
זה שינוי אופציונלי. מייצג את הגרסה הקיימת (העדכניות) של המוצר, ואפשר להשתמש בה כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אם המדיניות מוגדרת, המערכת מונעת את ההוספה של פריטים כשמספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון של המוצר אחרי 30 ימים) עם הערך הנוכחי של האפשרות הזו נתמכת רק עבור הכנסות למקורות נתונים ראשיים. אם הפעולה נמנעת, המערכת תבטל את החריגה שבוטלה. |
ProductStatus
הסטטוס של מוצר, בעיות באימות הנתונים, כלומר מידע על מוצר שמחושב באופן אסינכרוני.
שדות | |
---|---|
destination_statuses[] |
היעדים המיועדים של המוצר. |
item_level_issues[] |
רשימה של כל הבעיות שמשויכות למוצר הזה. |
creation_date |
התאריך שבו הפריט נוצר, בפורמט ISO 8601. |
last_update_date |
התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601. |
google_expiration_date |
התאריך שבו יפוג תוקף הפריט, בפורמט ISO 8601. |
DestinationStatus
סטטוס היעד של סטטוס המוצר.
שדות | |
---|---|
reporting_context |
השם של הקשר הדיווח. |
approved_countries[] |
רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם המוצר מאושר. |
pending_countries[] |
רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם המוצר בהמתנה לאישור. |
disapproved_countries[] |
רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם המוצר נפסל. |
ItemLevelIssue
השדה Item LevelIssue של סטטוס המוצר.
שדות | |
---|---|
code |
קוד השגיאה של הבעיה. |
severity |
איך הבעיה הזו משפיעה על הצגת המוצר. |
resolution |
האם המוכר יכול לפתור את הבעיה. |
attribute |
שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד. |
reporting_context |
ההקשר המדווח שאליו הבעיה מתייחסת. |
description |
תיאור קצר של הבעיה באנגלית. |
detail |
תיאור מפורט של הבעיה באנגלית. |
documentation |
כתובת ה-URL של דף אינטרנט כדי לעזור בפתרון הבעיה הזו. |
applicable_countries[] |
רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהם הבעיה רלוונטית למוצר. |
מידת החומרה
איך הבעיה משפיעה על הצגת המוצר.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
לא צוין. |
NOT_IMPACTED |
הבעיה הזו מייצגת אזהרה ואין לה השפעה ישירה על המוצר. |
DEMOTED |
המוצר יורד בדרגה וסביר להניח שהביצועים שלו יהיו מוגבלים בתוצאות החיפוש |
DISAPPROVED |
המוצר נפסל בגלל בעיה. |
ProductStructuredDescription
תיאור מובנה, לתיאורים שנוצרו באמצעות אלגוריתם (AI).
שדות | |
---|---|
digital_source_type |
סוג המקור הדיגיטלי, לדוגמה, "trained_algorithmic_media". מתבצע מעקב אחרי IPTC. האורך המרבי הוא 40 תווים. |
content |
טקסט התיאור האורך המקסימלי הוא 5,000 תווים |
ProductStructuredTitle
שם פריט מובנה, לשמות פריטים שנוצרו על ידי אלגוריתם (AI).
שדות | |
---|---|
digital_source_type |
סוג המקור הדיגיטלי, לדוגמה, 'trained_algorithmic_media'. מתבצע מעקב אחרי IPTC. האורך המרבי הוא 40 תווים. |
content |
טקסט הכותרת. האורך המקסימלי הוא 150 תווים |
ProductWeight
משקל המוצר.
שדות | |
---|---|
value |
חובה. המשקל שמיוצג כמספר. המשקל יכול להיות מדויק עד ארבע ספרות אחרי הנקודה העשרונית. |
unit |
חובה. יחידת המשקל. הערכים הקבילים הם: * " |
משלוח
משלוח המוצר.
שדות | |
---|---|
price |
מחיר משלוח קבוע, מיוצג כמספר. |
country |
קוד האזור במאגר CLDR של המדינה שאליה הפריט יישלח. |
region |
האזור הגיאוגרפי שעליו חל תעריף המשלוח. למידע נוסף, ראו אזור. |
service |
תיאור חופשי של רמת השירות או מהירות המסירה. |
location_id |
המזהה המספרי של מיקום שעליו חל תעריף המשלוח, כפי שמוגדר ב-AdWords API. |
location_group_name |
המיקום שבו חל המשלוח, מיוצג על ידי שם של קבוצת מיקומים. |
postal_code |
טווח המיקודים שעליהם חל תעריף המשלוח (מיוצג באמצעות מיקוד), קידומת של מיקוד ואחריה תו כללי לחיפוש *, טווח בין שני מספרי מיקוד או שתי קידומות של מיקוד באורך זהה. |
min_handling_time |
זמן טיפול מינימלי (כולל) בין מועד קבלת ההזמנה לבין שליחתה בימי עסקים. המשמעות של 0 היא שההזמנה נשלחת ביום שבו היא התקבלה, אם היא נמסרת לפני המועד האחרון להזמנה. אפשר להציג את [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] אפשר להציג רק יחד עם [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; אבל זה לא חובה אם המאפיין [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] מופיע. |
max_handling_time |
זמן הטיפול המקסימלי (כולל) מרגע קבלת ההזמנה ועד לשליחתה בימי עסקים. המשמעות של 0 היא שההזמנה נשלחת ביום שבו היא התקבלה, אם היא נמסרת לפני המועד האחרון להזמנה. אם מספקים מהירויות משלוח, צריך לציין גם [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] וגם [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. אם צוין [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time], המאפיין [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] הוא אופציונלי. |
min_transit_time |
זמן אספקה מינימלי (כולל) מרגע שליחת ההזמנה ועד למסירתה בימי עסקים. המשמעות של 0 היא שההזמנה נמסרת באותו יום שבו היא נשלחת. אפשר לציין את [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] אפשר להוסיף יחד עם [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; אבל לא חובה לספק אותו אם המאפיין [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] קיים. |
max_transit_time |
זמן ההובלה המקסימלי (כולל) מרגע שליחת ההזמנה ועד למסירתה בימי עסקים. המשמעות של 0 היא שההזמנה נמסרת באותו יום שבו היא נשלחת. אם מספקים מהירויות משלוח, צריך לציין גם [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] וגם [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. המאפיין [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] הוא אופציונלי אם המאפיין [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] מופיע. |
ShippingDimension
מאפיין המשלוח של המוצר.
שדות | |
---|---|
value |
מידות המוצר, המשמשות לחישוב עלות המשלוח של הפריט. |
unit |
יחידת הערך. |
ShippingWeight
משקל האריזה של המוצר.
שדות | |
---|---|
value |
משקל המוצר משמש לחישוב עלות המשלוח של הפריט. |
unit |
יחידת הערך. |
SubscriptionCost
עלות המינוי של המוצר.
שדות | |
---|---|
period |
הסוג של תקופת המינוי. הערכים הנתמכים הם: * " |
period_length |
מספר תקופות המינוי שהקונה צריך לשלם. |
amount |
הסכום שהקונה צריך לשלם בכל תקופת מינוי. |
SubscriptionPeriod
תקופת המינוי של המוצר.
טיפוסים בני מנייה (enum) | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
מציין שתקופת המינוי לא צוינה. |
MONTH |
מציין שתקופת המינוי היא חודש. |
YEAR |
מציין שתקופת המינוי היא שנה. |
מס
המס על המוצר.
שדות | |
---|---|
rate |
אחוז שיעור המס שחל על מחיר הפריט. |
country |
המדינה שבה מוטל מיסוי על הפריט, מצוינת כקוד האזור במאגר CLDR. |
region |
האזור הגיאוגרפי ששיעור המס חל עליו. |
tax_ship |
צריך להגדיר את הערך True אם גובים מס על המשלוח. |
location_id |
המזהה המספרי של מיקום ששיעור המס חל עליו, כפי שמוגדר ב-AdWords API. |
postal_code |
טווח המיקודים ששיעור המס חל עליו, מיוצג על ידי מיקוד, קידומת של מיקוד עם תו כללי לחיפוש *, טווח בין שני מיקודים או שתי קידומות של מיקוד באורך זהה. לדוגמה: 94114, 94*, 94002-95460, 94*-95*. |
UnitPricingBaseMeasure
הערך של UnitPricingBasemeasure של המוצר.
שדות | |
---|---|
value |
המכנה של המחיר ליחידה. |
unit |
היחידה של המכנה. |
UnitPricingMeasure
יחידת התמחור של המוצר.
שדות | |
---|---|
value |
המידות של פריט. |
unit |
יחידת המידה. |