דף זה תורגם על ידי Cloud Translation API.

Package google.shopping.merchant.products.v1beta

אינדקס

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 (הודעה)
ProductSustainabilityIncentive (הודעה)
ProductSustainabilityIncentive.Type (enum)
ProductWeight (הודעה)
Shipping (הודעה)
ShippingDimension (הודעה)
ShippingWeight (הודעה)
SubscriptionCost (הודעה)
SubscriptionPeriod (enum)
Tax (הודעה)
UnitPricingBaseMeasure (הודעה)
UnitPricingMeasure (הודעה)

ProductInputsService

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

DeleteProductInput

DeleteProductInput
`rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)` מחיקה של קלט של מוצר מחשבון Merchant Center. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: `https://www.googleapis.com/auth/content` מידע נוסף זמין בOAuth 2.0 Overview.

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

מחיקה של קלט של מוצר מחשבון Merchant Center.

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

היקפי הרשאה

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

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

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

InsertProductInput

InsertProductInput
`rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)` העלאת קלט של מוצרים לחשבון Merchant Center. אם כבר קיים קלט עם אותם ערכי contentLanguage,‏ offerId ו-dataSource, השיטה הזו מחליפה את הרשומה הזו. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: `https://www.googleapis.com/auth/content` מידע נוסף זמין בOAuth 2.0 Overview.

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

העלאת קלט של מוצרים לחשבון Merchant Center. אם כבר קיים קלט עם אותם ערכי contentLanguage,‏ offerId ו-dataSource, השיטה הזו מחליפה את הרשומה הזו.

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

היקפי הרשאה

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

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

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

ProductsService

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

GetProduct

GetProduct
`rpc GetProduct(GetProductRequest) returns (Product)` אחזור המוצר המעובד מחשבון Merchant Center. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר הסופי המעודכן. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: `https://www.googleapis.com/auth/content` מידע נוסף זמין בOAuth 2.0 Overview.

rpc GetProduct(GetProductRequest) returns (Product)

אחזור המוצר המעובד מחשבון Merchant Center.

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

היקפי הרשאה

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

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

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

ListProducts

ListProducts
`rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)` רשימה של המוצרים שעברו עיבוד בחשבון Merchant Center. יכול להיות שהתגובה תכיל פחות פריטים ממה שצוין ב-pageSize. להסתמך על pageToken כדי לקבוע אם יש פריטים נוספים שצריך לבקש. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: `https://www.googleapis.com/auth/content` מידע נוסף זמין בOAuth 2.0 Overview.

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

רשימה של המוצרים שעברו עיבוד בחשבון Merchant Center. יכול להיות שהתגובה תכיל פחות פריטים ממה שצוין ב-pageSize. להסתמך על pageToken כדי לקבוע אם יש פריטים נוספים שצריך לבקש.

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

היקפי הרשאה

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

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

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

מאפיינים

מאפיינים.

שדות
`additional_image_links[]`	`string` כתובות URL נוספות של תמונות של הפריט.
`expiration_date`	`Timestamp` התאריך שבו התוקף של הפריט יפוג, כפי שצוין בזמן ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל מוצג ב-`productstatuses` בתור googleExpirationDate, ויכול להיות שהוא יהיה מוקדם יותר אם `expirationDate` רחוק מדי בעתיד.
`disclosure_date`	`Timestamp` התאריך והשעה שבהם המבצע יתחיל להופיע בתוצאות חיפוש בפלטפורמות YouTube של Google, בפורמט ISO 8601. מידע נוסף זמין במאמר [תאריך הגילוי הנאות]( https://support.google.com/merchants/answer/13034208).
`availability_date`	`Timestamp` היום שבו מוצר שמוזמן מראש יהיה זמין למשלוח, בפורמט ISO 8601.
`gtin[]`	`string` מספרי הפריט המסחרי הגלובלי (GTIN) של הפריט. אפשר לספק עד 10 מק"טים.
`price`	`Price` מחיר הפריט.
`installment`	`Installment` מספר התשלומים וסכומן לרכישת פריט.
`subscription_cost`	`SubscriptionCost` מספר התקופות (חודשים או שנים) וסכום התשלום לכל תקופה עבור פריט עם חוזה מינוי משויך.
`loyalty_points`	`LoyaltyPoints` נקודות מועדון שהמשתמשים מקבלים אחרי רכישת הפריט. יפן בלבד.
`loyalty_programs[]`	`LoyaltyProgram` רשימה של פרטי תוכנית הנאמנות שמשמשת להצגת הטבות של תוכנית הנאמנות (לדוגמה, מחירים טובים יותר, נקודות וכו') למשתמש הפריט הזה.
`product_types[]`	`string` הקטגוריות של הפריט (בפורמט שמפורט במפרט נתוני המוצרים).
`sale_price`	`Price` מחיר המבצע שמפרסמים עבור הפריט.
`sale_price_effective_date`	`Interval` טווח התאריכים שבו הפריט נמכר במחיר מבצע (מידע נוסף זמין במפרט נתוני המוצרים).
`product_height`	`ProductDimension` גובה המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
`product_length`	`ProductDimension` אורך המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
`product_width`	`ProductDimension` רוחב המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
`product_weight`	`ProductWeight` משקל המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-2000 (כולל).
`shipping[]`	`Shipping` כללי משלוח.
`free_shipping_threshold[]`	`FreeShippingThreshold` התנאים שצריך לעמוד בהם כדי שמשלוח מוצר יהיה חינם.
`shipping_weight`	`ShippingWeight` משקל הפריט לצורך משלוח.
`shipping_length`	`ShippingDimension` אורך הפריט לצורך משלוח.
`shipping_width`	`ShippingDimension` רוחב הפריט לצורך משלוח.
`shipping_height`	`ShippingDimension` גובה הפריט לצורך משלוח.
`size_types[]`	`string` סוג החיתוך של הפריט. אפשר להשתמש בו כדי לייצג סוגי מידות משולבים של פריטי לבוש. אפשר לציין עד שני סוגים של מידות (מידע נוסף זמין במאמר [https://support.google.com/merchants/answer/6324497](סוג מידה)).
`taxes[]`	`Tax` פרטי מס.
`unit_pricing_measure`	`UnitPricingMeasure` המידה והממדים של פריט.
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` ההעדפה של המכנה של מחיר היחידה.
`ads_labels[]`	`string` בדומה ל-ads_grouping, אבל פועל רק על עלות לקליק.
`cost_of_goods_sold`	`Price` עלות המכר. משמש לדיווח על רווח גולמי.
`product_details[]`	`ProductDetail` מפרט טכני או פרטים נוספים על המוצר.
`product_highlights[]`	`string` נקודות שמתארות את הפרטים החשובים והרלוונטיים ביותר של מוצר.
`display_ads_similar_ids[]`	`string` המלצות שהמפרסם ציין.
`promotion_ids[]`	`string` המזהה הייחודי של המבצע.
`included_destinations[]`	`string` רשימת היעדים שצריך לכלול בשביל היעד הזה (הרשימה תואמת לתיבות שמסומנות ב-Merchant Center). יעדי ברירת מחדל תמיד נכללים, אלא אם צוינו ב-`excludedDestinations`.
`excluded_destinations[]`	`string` רשימת היעדים שצריך להחריג בשביל היעד הזה (הרשימה תואמת לתיבות שלא מסומנות ב-Merchant Center).
`shopping_ads_excluded_countries[]`	`string` רשימת קודי המדינות (ISO 3166-1 alpha-2) להחרגת המבצע מהיעד של מודעות השופינג. מדינות מהרשימה הזו יוסרו מהמדינות שהוגדרו בהגדרות של מקור הנתונים.
`lifestyle_image_links[]`	`string` כתובות URL נוספות של תמונות סגנון חיים של הפריט, שמשמשות לזיהוי מפורש של תמונות שמציגות את הפריט בהקשר של עולם אמיתי. מידע נוסף זמין במאמר הזה במרכז העזרה.
`cloud_export_additional_properties[]`	`CloudExportAdditionalProperties` שדות נוספים לייצוא לתוכנית Cloud Retail.
`certifications[]`	`Certification` אישורי מוצרים, למשל עבור תוויות יעילות אנרגטית של מוצרים שמופיעים במסד הנתונים של EPREL באיחוד האירופי. מידע נוסף זמין במאמר במרכז העזרה.
`auto_pricing_min_price`	`Price` אמצעי הגנה בפרויקטים 'הנחות אוטומטיות' (https://support.google.com/merchants/answer/10295759) ו'קידומי מכירות דינמיים' (https://support.google.com/merchants/answer/13949249), שמבטיח שההנחות על המוצרים של המוכרים לא יהיו נמוכות מהערך הזה, וכך שומר על הערך והרווחיות של המוצר.
`sustainability_incentives[]`	`ProductSustainabilityIncentive` רשימת תוכניות התמריצים לקידום הקיימות.
`identifier_exists`	`bool` מגדירים את הערך הזה כ-false אם אין לפריט מזהי מוצר ייחודיים שמתאימים לקטגוריה שלו, כמו מספר GTIN, קוד MPN ומותג. אם לא מציינים ערך, ברירת המחדל היא true.
`is_bundle`	`bool` אם הפריט הוא חבילה שמוגדרת על ידי המוכר. חבילה היא קיבוץ מותאם אישית של מוצרים שונים שנמכרים על ידי מוכר במחיר כולל.
`title`	`string` השם של הפריט.
`description`	`string` תיאור הפריט.
`link`	`string` כתובת URL שמקשרת ישירות לדף הפריט בחנות הווירטואלית.
`mobile_link`	`string` כתובת ה-URL של הגרסה של דף הנחיתה של הפריט שמותאמת לניידים.
`canonical_link`	`string` כתובת ה-URL של הגרסה הקנונית של דף הנחיתה של הפריט.
`image_link`	`string` כתובת ה-URL של תמונת הפריט.
`adult`	`bool` מגדירים את הערך כ-true אם הפריט מיועד למבוגרים.
`age_group`	`string` קבוצת הגיל שאליה מיועד הפריט.
`availability`	`string` סטטוס הזמינות של הפריט.
`brand`	`string` המותג של הפריט.
`color`	`string` צבע הפריט.
`condition`	`string` מצב הפריט.
`gender`	`string` המגדר שאליו מיועד הפריט.
`google_product_category`	`string` הקטגוריה של הפריט ב-Google (ראו טקסונומיית המוצרים של Google). כששולחים שאילתה לגבי מוצרים, השדה הזה מכיל את הערך שהמשתמש סיפק. נכון לעכשיו אין דרך להחזיר את קטגוריות המוצרים של Google שהוקצו באופן אוטומטי דרך ה-API.
`item_group_id`	`string` מזהה משותף לכל הווריאציות של אותו מוצר.
`material`	`string` החומר שממנו עשוי הפריט.
`mpn`	`string` מספר החלק שהיצרן הקצה לפריט (MPN).
`pattern`	`string` הדוגמה של הפריט (לדוגמה, נקודות).
`sell_on_google_quantity`	`int64` הכמות של המוצר שזמינה למכירה ב-Google. התכונה נתמכת רק במוצרים אונליין.
`max_handling_time`	`int64` זמן הטיפול המקסימלי במוצר (בימי עסקים).
`min_handling_time`	`int64` זמן הטיפול המינימלי במוצר (בימי עסקים).
`shipping_label`	`string` תווית המשלוח של המוצר, שמשמשת לקבץ מוצרים בכללי משלוח ברמת החשבון.
`transit_time_label`	`string` תווית זמן ההובלה של המוצר, שמשמשת לקבץ מוצרים בטבלאות של זמני הובלה ברמת החשבון.
`size`	`string` גודל הפריט. מותר להזין רק ערך אחד. וריאציות עם מידות שונות: מוסיפים מוצר נפרד לכל מידה עם אותו ערך של `itemGroupId` (מידע נוסף זמין במאמר [https://support.google.com/merchants/answer/6324492](הגדרת מידה)).
`size_system`	`string` המערכת שבה מצוין הגודל. מומלץ לפריטי לבוש.
`tax_category`	`string` קטגוריית המס של המוצר.
`energy_efficiency_class`	`string` סיווג יעילות האנרגיה כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
`min_energy_efficiency_class`	`string` סיווג יעילות האנרגיה כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
`max_energy_efficiency_class`	`string` סיווג יעילות האנרגיה כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
`multipack`	`int64` מספר המוצרים הזהים במארז של כמה יחידות, לפי הגדרת המוכר.
`ads_grouping`	`string` מאפיין זה מאפשר לקבץ פריטים בדרך שרירותית. רק ל-CPA%, לא מומלץ להשתמש בו במקרים אחרים.
`ads_redirect`	`string` המאפיין הזה מאפשר למפרסמים לשנות את כתובת ה-URL של הפריט כשהמודעה עם המוצר מוצגת בהקשר של מודעות מוצרים.
`display_ads_id`	`string` מזהה פריט לקמפיינים של רימרקטינג דינמי.
`display_ads_title`	`string` שם הפריט בקמפיינים של רימרקטינג דינמי.
`display_ads_link`	`string` כתובת URL שמובילה ישירות אל דף הנחיתה של הפריט ומיועדת לקמפיינים של רימרקטינג דינמי.
`display_ads_value`	`double` שולי הרווח בקמפיינים של רימרקטינג דינמי.
`pickup_method`	`string` אפשרות האיסוף של הפריט.
`pickup_sla`	`string` ציר זמן לאיסוף הפריט מהחנות.
`link_template`	`string` תבנית קישור לדף של חנות מקומית באתר של המוכר.
`mobile_link_template`	`string` תבנית קישור לדף חנות מקומית באתר של המוכר שמותאמת לניידים.
`custom_label_0`	`string` תווית מותאמת אישית 0 לקיבוץ פריטים בהתאמה אישית בקמפיין שופינג.
`custom_label_1`	`string` תווית מותאמת אישית 1 לקיבוץ פריטים בהתאמה אישית בקמפיין שופינג.
`custom_label_2`	`string` תווית מותאמת אישית 2 לקיבוץ פריטים בהתאמה אישית בקמפיין שופינג.
`custom_label_3`	`string` תווית מותאמת אישית 3 לקיבוץ פריטים בהתאמה אישית בקמפיין שופינג.
`custom_label_4`	`string` תווית מותאמת אישית 4 לקיבוץ פריטים בהתאמה אישית בקמפיין שופינג.
`external_seller_id`	`string` חובה בחשבונות שמוגדרים בהם כמה אתרי מכירה. המאפיין הזה מתאים אם אתם מנהלים זירת מסחר שמעלה מוצרים של אתרי מכירה שונים לחשבון מרובה אתרי מכירה.
`pause`	`string` הפרסום של הפריט הזה יושהה באופן זמני.
`virtual_model_link`	`string` כתובת ה-URL של התמונה התלת-ממדית של הפריט. מידע נוסף זמין במאמר הזה במרכז העזרה.
`structured_title`	`ProductStructuredTitle` שם פריט מובנה, לשמות פריטים שנוצרו באופן אלגוריתמי (AI).
`structured_description`	`ProductStructuredDescription` תיאור מובנה, לתיאורים שנוצרו באופן אלגוריתמי (AI).

הסמכה

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

שדות
`certification_authority`	`string` רשות האישורים, לדוגמה European_Commission. האורך המקסימלי הוא 2,000 תווים.
`certification_name`	`string` שם האישור, לדוגמה 'EPREL'. האורך המקסימלי הוא 2,000 תווים.
`certification_code`	`string` קוד האישור. האורך המקסימלי הוא 2,000 תווים.
`certification_value`	`string` ערך האישור (נקרא גם סיווג, רמה או ציון), לדוגמה 'A+‎', 'C', 'זהב'. האורך המקסימלי הוא 2,000 תווים.

CloudExportAdditionalProperties

מאפיין המוצר של Cloud Retail API. לדוגמה, מאפיינים של מוצר טלוויזיה יכולים להיות 'רזולוציית מסך' או 'גודל מסך'.

שדות
`text_value[]`	`string` ערך הטקסט של המאפיין הנתון. לדוגמה, '8K(UHD)' יכול להיות ערך טקסט של מוצר טלוויזיה. הערך הזה יכול לחזור על עצמו עד 400 פעמים. הערכים נשמרים בסדר שרירותי אבל עקבי. הגודל המקסימלי של מחרוזת הוא 256 תווים.
`int_value[]`	`int64` ערכים שלמים של המאפיין הנתון. לדוגמה, 1080 עבור רזולוציית המסך של מוצר טלוויזיה. הערך הזה יכול לחזור על עצמו עד 400 פעמים. הערכים נשמרים בסדר שרירותי אבל עקבי.
`float_value[]`	`float` ערכים של מספרים ממשיים של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 1.2345. הערך הזה יכול לחזור על עצמו עד 400 פעמים. הערכים נשמרים בסדר שרירותי אבל עקבי.
`property_name`	`string` השם של הנכס הנתון. לדוגמה, 'רזולוציית מסך' למוצר טלוויזיה. הגודל המקסימלי של מחרוזת הוא 256 תווים.
`bool_value`	`bool` הערך הבוליאני של המאפיין הנתון. לדוגמה, במוצר טלוויזיה, 'True' או 'False' אם המסך הוא UHD.
`min_value`	`float` הערך המינימלי של המאפיין הנתון. לדוגמה, עבור מוצר טלוויזיה, 1.00.
`max_value`	`float` הערך המקסימלי של המספר הממשי של המאפיין הנתון. לדוגמה, עבור מוצר טלוויזיה, 100.00.
`unit_code`	`string` היחידה של הנכס הנתון. לדוגמה, 'Pixels' למוצר טלוויזיה. הגודל המקסימלי של מחרוזת הוא 256B.

DeleteProductInputRequest

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

שדות

שדות
`name`	`string` חובה. השם של משאב הקלט של המוצר שרוצים למחוק. הפורמט: accounts/{account}/productInputs/{product}, כאשר הקטע האחרון `product` מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם מוצר היא "accounts/123/productInputs/online~iw~IL~sku123"
`data_source`	`string` חובה. מקור הנתונים הראשי או המשלים שממנו צריך למחוק את הקלט של המוצר. פורמט: `accounts/{account}/dataSources/{datasource}`

name

string

חובה. השם של משאב הקלט של המוצר שרוצים למחוק. הפורמט: accounts/{account}/productInputs/{product}, כאשר הקטע האחרון product מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם מוצר היא "accounts/123/productInputs/online~iw~IL~sku123"

data_source

string

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

FreeShippingThreshold

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

שדות

שדות
`country`	`string` קוד הטריטוריה במאגר CLDR של המדינה שאליה יישלח הפריט.
`price_threshold`	`Price` מחיר המוצר המינימלי שעבורו עלות המשלוח תהיה בחינם. מיוצג כמספר.

country

string

קוד הטריטוריה במאגר CLDR של המדינה שאליה יישלח הפריט.

price_threshold

Price

מחיר המוצר המינימלי שעבורו עלות המשלוח תהיה בחינם. מיוצג כמספר.

GetProductRequest

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

שדות

שדות
`name`	`string` חובה. השם של המוצר שרוצים לאחזר. פורמט: `accounts/{account}/products/{product}` כאשר הקטע האחרון `product` מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם מוצר היא "accounts/123/products/online~iw~IL~sku123"

name

string

חובה. השם של המוצר שרוצים לאחזר. פורמט: accounts/{account}/products/{product} כאשר הקטע האחרון product מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם מוצר היא "accounts/123/products/online~iw~IL~sku123"

InsertProductInputRequest

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

שדות

שדות
`parent`	`string` חובה. החשבון שאליו יתווסף המוצר. פורמט: accounts/{account}
`product_input`	`ProductInput` חובה. קלט המוצר שרוצים להוסיף.
`data_source`	`string` חובה. השם של מקור הנתונים הראשי או המשלים לנתוני המוצרים. אם המוצר כבר קיים ומקור הנתונים שצוין שונה, המוצר יועבר למקור נתונים חדש. יש תמיכה רק במקורות נתונים של API. פורמט: `accounts/{account}/dataSources/{datasource}`

parent

string

חובה. החשבון שאליו יתווסף המוצר. פורמט: accounts/{account}

product_input

ProductInput

חובה. קלט המוצר שרוצים להוסיף.

data_source

string

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

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

פורמט: accounts/{account}/dataSources/{datasource}

תשלומים

הודעה שמייצגת תשלום.

שדות
`months`	`int64` מספר התשלומים שהקונה צריך לשלם.
`amount`	`Price` הסכום שהקונה צריך לשלם כל חודש.
`downpayment`	`Price` סכום המקדמה שעל הקונה לשלם מראש.
`credit_type`	`string` סוג התשלומים בתשלומים. הערכים הנתמכים הם: * "`finance`" * "`lease`"

ListProductsRequest

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

שדות

שדות
`parent`	`string` חובה. החשבון שבו רוצים להציג את המוצרים שעברו עיבוד. פורמט: accounts/{account}
`page_size`	`int32` המספר המקסימלי של מוצרים להחזרה. יכול להיות שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 250. ערכים מעל 250 יומרו לערך 250. אם לא מציינים ערך, יופיע המספר המקסימלי של מוצרים.
`page_token`	`string` אסימון דף, שהתקבל משיחה קודמת של `ListProducts`. יש לספק אותו כדי לאחזר את הדף הבא. כשמחלקים את הדפים, כל הפרמטרים האחרים שסופקו ל-`ListProducts` חייבים להתאים לקריאה שסיפקה את אסימון הדף.

parent

string

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

page_size

int32

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

page_token

string

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

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

ListProductsResponse

הודעת התגובה של השיטה ListProducts.

שדות

שדות
`products[]`	`Product` המוצרים שעברו עיבוד מהחשבון שצוין. אלה המוצרים שעברו עיבוד אחרי החלת הכללים ומקורות הנתונים המשלים.
`next_page_token`	`string` אסימון שאפשר לשלוח כ-`page_token` כדי לאחזר את הדף הבא. אם השדה הזה לא יצוין, לא יהיו דפים נוספים.

products[]

Product

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

next_page_token

string

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

LoyaltyPoints

הודעה שמייצגת נקודות מועדון.

שדות

שדות
`name`	`string` השם של תוכנית הנקודות של המועדון. מומלץ להגביל את השם ל-12 תווים רחבים או ל-24 תווים לטיניים.
`points_value`	`int64` נקודות הנאמנות של הקמעונאי בערך מוחלט.
`ratio`	`double` היחס של נקודה כשממירים אותה למטבע. Google מניחה את המטבע על סמך ההגדרות ב-Merchant Center. אם לא מציינים את היחס, הערך שמוגדר כברירת מחדל הוא 1.0.

name

string

השם של תוכנית הנקודות של המועדון. מומלץ להגביל את השם ל-12 תווים רחבים או ל-24 תווים לטיניים.

points_value

int64

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

ratio

double

היחס של נקודה כשממירים אותה למטבע. Google מניחה את המטבע על סמך ההגדרות ב-Merchant Center. אם לא מציינים את היחס, הערך שמוגדר כברירת מחדל הוא 1.0.

LoyaltyProgram

הודעה שמייצגת את מועדון הלקוחות.

שדות
`program_label`	`string` התווית של מועדון הלקוחות. זוהי תווית פנימית שמזהה באופן ייחודי את הקשר בין ישות של מוכר לבין ישות של תוכנית נאמנות. צריך לספק את התווית כדי שהמערכת תוכל לשייך את הנכסים הבאים (לדוגמה, מחיר ונקודות) למוכרים. צריך לקשר את התוכנית המתאימה לחשבון המוכר.
`tier_label`	`string` התווית של הרמה במועדון הלקוחות. חייב להתאים לאחת מהתוויות בתוכנית.
`price`	`Price` המחיר לחברי המועדון ברמה הנתונה, כלומר מחיר ההנחה המיידית. המחיר צריך להיות קטן מהמחיר הרגיל או שווה לו.
`cashback_for_future_use`	`Price` הקאשבק שאפשר להשתמש בו ברכישות עתידיות.
`loyalty_points`	`int64` מספר נקודות המועדון שנצברו ברכישה.
`member_price_effective_date`	`Interval` טווח תאריכים שבו הפריט עומד בדרישות לקבלת מחיר החברים. אם לא יצוין מחיר, תמיד יוחל המחיר למנויים. טווח התאריכים מיוצג על ידי צמד תאריכים בפורמט ISO 8601 המופרדים באמצעות רווח, פסיק או קו נטוי.
`shipping_label`	`string` התווית של הטבת המשלוח. אם בשדה מופיע ערך, המבצע הזה כולל הטבת משלוח של מועדון הלקוחות. אם לא צוין ערך בשדה, הפריט לא עומד בדרישות לקבלת משלוח של מועדון הלקוחות ברמת החברות הנתונה.

מוצר

המוצר המעובד, שנוצר מכמה product inputs אחרי החלת כללים ומקורות נתונים משלימים. המוצר המעובד הזה תואם למוצר שמוצג בחשבון Merchant Center שלכם, במודעות שופינג ובפלטפורמות אחרות של Google. כל מוצר נוצר מנתוני מוצר אחד בלבד ממקור הנתונים הראשי וממספר מקורות נתונים משלימים. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן.

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

שדות
`name`	`string` שם המוצר. פורמט: `"{product.name=accounts/{account}/products/{product}}"` כאשר הקטע האחרון `product` מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם מוצר היא "accounts/123/products/online~iw~IL~sku123"
`channel`	`ChannelEnum` פלט בלבד. הערוץ של המוצר.
`offer_id`	`string` פלט בלבד. המזהה הייחודי של המוצר. הערך הזה זהה לקלט של המוצר ולמוצר המעובד. רווחים לבנים בתחילת הטקסט ובסופו יוסרו, ורווחים מרובים יוחלפו ברווח אחד בזמן השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים.
`content_language`	`string` פלט בלבד. קוד השפה בן שתי האותיות של המוצר לפי תקן ISO 639-1.
`feed_label`	`string` פלט בלבד. תווית הפיד של המוצר.
`data_source`	`string` פלט בלבד. מקור הנתונים הראשי של המוצר.
`attributes`	`Attributes` פלט בלבד. רשימה של מאפייני מוצרים.
`custom_attributes[]`	`CustomAttribute` פלט בלבד. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש בו כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית (לדוגמה, `{ "name": "size type", "value": "regular" }`). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפים באופן מפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים את 'קונים ב-Google'.
`product_status`	`ProductStatus` פלט בלבד. סטטוס המוצר, בעיות באימות הנתונים, כלומר מידע על מוצר שמחושב באופן אסינכרוני.
`version_number`	`int64` פלט בלבד. מייצג את הגרסה הקיימת (עדכניות) של המוצר, וניתן להשתמש בו כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אם ההגדרה הזו מוגדרת, ההוספה לא תתבצע אם מספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון המוצר אחרי 30 יום) באמצעות `version_number` הנוכחי. התכונה נתמכת רק להוספה למקורות נתונים ראשיים. אם הפעולה תימנע, תופעל החריגה 'הפעולה בוטלה'.

ProductDetail

פרטי המוצר.

שדות

שדות
`section_name`	`string` הכותרת של הקטע שמשמשת לקבץ קבוצה של פרטי מוצרים.
`attribute_name`	`string` השם של פרטי המוצר.
`attribute_value`	`string` הערך של פרטי המוצר.

section_name

string

הכותרת של הקטע שמשמשת לקבץ קבוצה של פרטי מוצרים.

attribute_name

string

השם של פרטי המוצר.

attribute_value

string

הערך של פרטי המוצר.

ProductDimension

המאפיין 'מידה' של המוצר.

שדות

שדות
`value`	`double` חובה. ערך המאפיין שמוצג כמספר. הערך יכול להיות מדויק עד ארבע ספרות אחרי הנקודה העשרונית.
`unit`	`string` חובה. יחידות המידה של המאפיינים. הערכים הקבילים הם: * "`in`" * "`cm`"

value

double

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

unit

string

חובה. יחידות המידה של המאפיינים. הערכים הקבילים הם: * "in" * "cm"

ProductInput

המשאב הזה מייצג את נתוני הקלט ששולחים לגבי מוצר, ולא את המוצר המעובד שמוצג ב-Merchant Center, במודעות שופינג או בפלטפורמות השונות של Google. הקלט של המוצרים, הכללים והנתונים של מקורות הנתונים המשניים משולבים כדי ליצור את Product המעובד.

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

המאפיינים הבאים נדרשים: feedLabel, ‏ contentLanguage ו-offerId.

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

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

שדות
`name`	`string` מזהה. השם של קלט המוצר. פורמט: `"{productinput.name=accounts/{account}/productInputs/{productinput}}"` כאשר הקטע האחרון `productinput` מורכב מ-4 חלקים: channel~content_language~feed_label~offer_id. דוגמה לשם של קלט מוצר היא "accounts/123/productInputs/online~iw~IL~sku123"
`product`	`string` פלט בלבד. השם של המוצר המעובד. פורמט: `"{product.name=accounts/{account}/products/{product}}"`
`channel`	`ChannelEnum` לא ניתן לשינוי. הערוץ של המוצר.
`offer_id`	`string` חובה. לא ניתן לשינוי. המזהה הייחודי של המוצר. הערך הזה זהה לקלט של המוצר ולמוצר המעובד. רווחים לבנים בתחילת הטקסט ובסופו יוסרו, ורווחים מרובים יוחלפו ברווח אחד בזמן השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים.
`content_language`	`string` חובה. לא ניתן לשינוי. קוד השפה בן שתי האותיות של המוצר לפי תקן ISO 639-1.
`feed_label`	`string` חובה. לא ניתן לשינוי. תווית הפיד של המוצר.
`attributes`	`Attributes` זה שינוי אופציונלי. רשימה של מאפייני מוצרים.
`custom_attributes[]`	`CustomAttribute` זה שינוי אופציונלי. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש בו כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית (לדוגמה, `{ "name": "size type", "value": "regular" }`). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפים במפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים את 'קונים ב-Google'. מספר התווים המקסימלי לכל מאפיין מותאם אישית הוא 10,240 (הערך הזה מייצג את הסכום של התווים בשם ובערך). אפשר להגדיר עד 2,500 מאפיינים מותאמים אישית לכל מוצר, בגודל כולל של 102.4KB. קווים תחתונים בשמות של מאפיינים מותאמים אישית מוחלפים ברווחים בזמן ההוספה.
`version_number`	`int64` זה שינוי אופציונלי. מייצג את הגרסה הקיימת (עדכניות) של המוצר, וניתן להשתמש בו כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אם ההגדרה הזו מוגדרת, ההוספה לא תתבצע אם מספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון המוצר אחרי 30 יום) באמצעות `version_number` הנוכחי. התכונה נתמכת רק להוספה למקורות נתונים ראשיים. אם הפעולה תימנע, תופעל החריגה 'הפעולה בוטלה'.

ProductStatus

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

שדות
`destination_statuses[]`	`DestinationStatus` היעדים המיועדים למוצר.
`item_level_issues[]`	`ItemLevelIssue` רשימה של כל הבעיות שמשויכות למוצר.
`creation_date`	`Timestamp` התאריך שבו הפריט נוצר, בפורמט ISO 8601.
`last_update_date`	`Timestamp` התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601.
`google_expiration_date`	`Timestamp` התאריך שבו התוקף של הפריט יפוג, בפורמט ISO 8601.

DestinationStatus

סטטוס היעד של סטטוס המוצר.

שדות
`reporting_context`	`ReportingContextEnum` השם של ההקשר של הדיווח.
`approved_countries[]`	`string` רשימת קודי המדינות (ISO 3166-1 alpha-2) שבהן המבצע מאושר.
`pending_countries[]`	`string` רשימת קודי המדינות (ISO 3166-1 alpha-2) שבהן המבצע בהמתנה לאישור.
`disapproved_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן המבצע נדחה.

ItemLevelIssue

הבעיה ברמת הפריט בסטטוס המוצר.

שדות
`code`	`string` קוד השגיאה של הבעיה.
`severity`	`Severity` איך הבעיה הזו משפיעה על הצגת המבצע.
`resolution`	`string` אם המוכר יכול לפתור את הבעיה.
`attribute`	`string` שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד.
`reporting_context`	`ReportingContextEnum` ההקשר של הדיווח שאליו הבעיה רלוונטית.
`description`	`string` תיאור קצר של הבעיה באנגלית.
`detail`	`string` תיאור מפורט של הבעיה באנגלית.
`documentation`	`string` כתובת ה-URL של דף אינטרנט שיעזור לנו לפתור את הבעיה.
`applicable_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן הבעיה רלוונטית למבצע.

מידת החומרה

איך הבעיה משפיעה על הצגת המוצר.

טיפוסים בני מנייה (enum)
`SEVERITY_UNSPECIFIED`	לא צוין.
`NOT_IMPACTED`	הבעיה הזו היא אזהרה ואין לה השפעה ישירה על המוצר.
`DEMOTED`	המוצר יורד לסטטוס נמוך יותר, וסביר להניח שהביצועים שלו בתוצאות החיפוש יהיו מוגבלים
`DISAPPROVED`	הבעיה גורמת לפסילה של המוצר.

ProductStructuredDescription

תיאור מובנה, לתיאורים שנוצרו באופן אלגוריתמי (AI).

שדות

שדות
`digital_source_type`	`string` סוג המקור הדיגיטלי, לדוגמה 'trained_algorithmic_media'. לפי IPTC. האורך המרבי הוא 40 תווים.
`content`	`string` האורך המקסימלי של טקסט התיאור הוא 5,000 תווים

digital_source_type

string

סוג המקור הדיגיטלי, לדוגמה 'trained_algorithmic_media'. לפי IPTC. האורך המרבי הוא 40 תווים.

content

string

האורך המקסימלי של טקסט התיאור הוא 5,000 תווים

ProductStructuredTitle

שם פריט מובנה, לשמות פריטים שנוצרו באופן אלגוריתמי (AI).

שדות

שדות
`digital_source_type`	`string` סוג המקור הדיגיטלי, לדוגמה 'trained_algorithmic_media'. לפי IPTC. האורך המרבי הוא 40 תווים.
`content`	`string` האורך המקסימלי של טקסט הכותרת הוא 150 תווים

digital_source_type

string

סוג המקור הדיגיטלי, לדוגמה 'trained_algorithmic_media'. לפי IPTC. האורך המרבי הוא 40 תווים.

content

string

האורך המקסימלי של טקסט הכותרת הוא 150 תווים

ProductSustainabilityIncentive

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

שדות
שדה האיחוד `value`. הערך של התמריץ לקיימות. הערך של `value` יכול להיות רק אחת מהאפשרויות הבאות:
`amount`	`Price` הסכום הקבוע של התמריץ.
`percentage`	`double` האחוז של מחיר המכירה שבו חל התמריץ.
`type`	`Type` תוכנית תמריצים בנושא קיימות.

סוג

סוגי תוכניות התמריצים הנתמכות בתחום הקיימות.

טיפוסים בני מנייה (enum)
`TYPE_UNSPECIFIED`	סוג תמריץ לא ידוע או לא מוגדר בנושא קיימות.
`EV_TAX_CREDIT`	תוכנית שמציעה הנחות במס על רכבים חשמליים, ובמדינות מסוימות גם על רכבים היברידיים נטענים. ההנחות האלה יכולות להתבסס על סכום ספציפי או על אחוז ממחיר המכירה.
`EV_PRICE_DISCOUNT`	תוכנית סובסידיה, שנקראת לרוב 'בונוס סביבתי', מספקת מענק רכישה לרכבים חשמליים, ובמדינות מסוימות גם לרכבים היברידיים נטענים. סכום המענק יכול להיות סכום קבוע או אחוז ממחיר המכירה.

ProductWeight

משקל המוצר.

שדות

שדות
`value`	`double` חובה. המשקל מיוצג כמספר. הדיוק של המשקל יכול להיות עד ארבע ספרות אחרי הנקודה העשרונית.
`unit`	`string` חובה. יחידת המשקל. הערכים הקבילים הם: * "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

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

unit

string

חובה. יחידת המשקל. הערכים הקבילים הם: * "g" * "kg" * "oz" * "lb"

משלוח

משלוח המוצר.

שדות
`price`	`Price` מחיר משלוח קבוע, שמוצג כמספר.
`country`	`string` קוד הטריטוריה במאגר CLDR של המדינה שאליה יישלח הפריט.
`region`	`string` האזור הגיאוגרפי שאליו חלה עלות משלוח. מידע נוסף זמין במאמר region.
`service`	`string` תיאור חופשי של סיווג השירות או מהירות המשלוח.
`location_id`	`int64` המזהה המספרי של מיקום שבו חל עלות המשלוח, כפי שמוגדר ב-AdWords API.
`location_group_name`	`string` המיקום שבו אפשרות המשלוח רלוונטית, שמיוצג על ידי שם של קבוצת מיקומים.
`postal_code`	`string` טווח המיקוד שאליו חל התעריף למשלוח, שמיוצג על ידי מיקוד, קידומת של מיקוד ואחריה תו כללי לחיפוש *, טווח בין שני מספרי מיקוד או שתי קידומות של מספרי מיקוד באורך זהה.
`min_handling_time`	`int64` זמן הטיפול המינימלי (כולל) ממועד קבלת ההזמנה ועד לשליחתה בימי עסקים. הערך 0 מציין שההזמנה תישלח באותו יום שבו היא תתקבל, אם היא תתקבל לפני המועד האחרון להזמנה. הערך `minHandlingTime` יכול להופיע רק יחד עם הערך `maxHandlingTime`, אבל הוא לא נדרש אם הערך `maxHandlingTime` מופיע.
`max_handling_time`	`int64` זמן הטיפול המקסימלי (כולל) ממועד קבלת ההזמנה ועד לשליחתה בימי עסקים. הערך 0 מציין שההזמנה תישלח באותו יום שבו היא תתקבל, אם היא תתקבל לפני המועד האחרון להזמנה. אם אתם מספקים מהירויות משלוח, חובה לציין את הערכים של `maxHandlingTime` ושל `maxTransitTime`. הערך `minHandlingTime` הוא אופציונלי אם הערך `maxHandlingTime` קיים.
`min_transit_time`	`int64` זמן האספקה המינימלי (כולל) ממועד שליחת ההזמנה ועד למועד המסירה שלה בימי עסקים. הערך 0 מציין שההזמנה נמסרת באותו יום שבו היא נשלחת. הערך `minTransitTime` יכול להופיע רק יחד עם הערך `maxTransitTime`, אבל הוא לא נדרש אם הערך `maxTransitTime` מופיע.
`max_transit_time`	`int64` זמן האספקה המקסימלי (כולל) ממועד שליחת ההזמנה ועד למועד המסירה שלה בימי עסקים. הערך 0 מציין שההזמנה נמסרת באותו יום שבו היא נשלחת. אם אתם מספקים מהירויות משלוח, חובה לציין את הערכים של `maxHandlingTime` ושל `maxTransitTime`. הערך `minTransitTime` הוא אופציונלי אם הערך `maxTransitTime` קיים.

ShippingDimension

המאפיין ShippingDimension של המוצר.

שדות

שדות
`value`	`double` המאפיין של המוצר שמשמש לחישוב עלות המשלוח של הפריט.
`unit`	`string` יחידת הערך.

value

double

המאפיין של המוצר שמשמש לחישוב עלות המשלוח של הפריט.

unit

string

יחידת הערך.

ShippingWeight

משקל האריזה של המוצר.

שדות

שדות
`value`	`double` משקל המוצר המשמש לחישוב עלות המשלוח של הפריט.
`unit`	`string` יחידת הערך.

value

double

משקל המוצר המשמש לחישוב עלות המשלוח של הפריט.

unit

string

יחידת הערך.

SubscriptionCost

הערך של SubscriptionCost של המוצר.

שדות

שדות
`period`	`SubscriptionPeriod` סוג תקופת המינוי. הערכים הנתמכים הם: * "`month`" * "`year`"
`period_length`	`int64` מספר תקופות המינוי שהקונה צריך לשלם עליהן.
`amount`	`Price` הסכום שהקונה צריך לשלם בכל תקופת מינוי.

period

SubscriptionPeriod

סוג תקופת המינוי. הערכים הנתמכים הם: * "month" * "year"

period_length

int64

מספר תקופות המינוי שהקונה צריך לשלם עליהן.

amount

Price

הסכום שהקונה צריך לשלם בכל תקופת מינוי.

SubscriptionPeriod

תקופת המינוי של המוצר.

טיפוסים בני מנייה (enum)
`SUBSCRIPTION_PERIOD_UNSPECIFIED`	מציין שתקופת המינוי לא צוינה.
`MONTH`	מציין שתקופת המינוי היא חודש.
`YEAR`	מציין שתקופת המינוי היא שנה.

מס

המס על המוצר.

שדות
`rate`	`double` אחוז שיעור המס שחלה על מחיר הפריט.
`country`	`string` המדינה שבה הפריט חייב במס, שצוינה כקוד טריטוריה ב-CLDR.
`region`	`string` האזור הגיאוגרפי שאליו חל שיעור המס.
`tax_ship`	`bool` מגדירים את הערך כ-true אם נגבה מס על המשלוח.
`location_id`	`int64` המזהה המספרי של מיקום שבו חל שיעור המס, כפי שמוגדר ב-AdWords API.
`postal_code`	`string` טווח המיקוד שאליו חל שיעור המס, שמיוצג על ידי מיקוד, קידומת של מיקוד עם תו כללי לחיפוש (‎ * ‎), טווח בין שני מקודים או שתי קידומות של מקודים באורך זהה. דוגמאות: 94114, ‏‎94‎‏, ‏‎94002-95460‎‏, ‏‎94-95*‎‏.

UnitPricingBaseMeasure

UnitPricingBaseMeasure של המוצר.

שדות

שדות
`value`	`int64` המכנה של מחיר היחידה.
`unit`	`string` היחידות של המכנה.

value

int64

המכנה של מחיר היחידה.

unit

string

היחידות של המכנה.

UnitPricingMeasure

UnitPricingMeasure של המוצר.

שדות

שדות
`value`	`double` המדד של פריט.
`unit`	`string` יחידת המידה.

value

double

המדד של פריט.

unit

string

יחידת המידה.

Package google.shopping.merchant.products.v1beta קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

אינדקס

ProductInputsService

ProductsService

מאפיינים

הסמכה

CloudExportAdditionalProperties

DeleteProductInputRequest

FreeShippingThreshold

GetProductRequest

InsertProductInputRequest

תשלומים

ListProductsRequest

ListProductsResponse

LoyaltyPoints

LoyaltyProgram

מוצר

ProductDetail

ProductDimension

ProductInput

ProductStatus

DestinationStatus

ItemLevelIssue

מידת החומרה

ProductStructuredDescription

ProductStructuredTitle

ProductSustainabilityIncentive

סוג

ProductWeight

משלוח

ShippingDimension

ShippingWeight

SubscriptionCost

SubscriptionPeriod

מס

UnitPricingBaseMeasure

UnitPricingMeasure

Package google.shopping.merchant.products.v1beta