Package google.shopping.merchant.products.v1beta

אינדקס

ProductInputsService

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

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

מחיקת קלט של מוצר מחשבון Merchant Center שלכם.

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

היקפי ההרשאות

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

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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

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

היקפי ההרשאות

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

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ProductsService

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

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

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

היקפי ההרשאות

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

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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

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

היקפי ההרשאות

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

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

מאפיינים

מאפיינים.

שדות
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.
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 (לא כולל) ל-3,000 (כולל).
product_length

ProductDimension

אורך המוצר ביחידות שסופקו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל).
product_width

ProductDimension

רוחב המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל).
product_weight

ProductWeight

משקל המוצר ביחידות שסופקו. הערך חייב להיות בין 0 (לא כולל) ל-2,000 (כולל).
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](size type)).
taxes[]

Tax

פרטי המס.
unit_pricing_measure

UnitPricingMeasure

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

UnitPricingBaseMeasure

העדפה של המכנה של המחיר ליחידה.
ads_labels[]

string

דומה למאפיין ads_grouping, אבל הוא פועל רק לפי עלות לקליק (CPC).
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) שבהם מצוין המוצר להחרגה מהיעד של מודעות שופינג. מדינות מהרשימה הזו יוסרו ממדינות שהוגדרו בהגדרות של מקור הנתונים.
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), כדי להבטיח שההנחות על מוצרים של מוכרים לא יהיו מתחת לערך הזה, וכך לשמור על הערך והרווחיות של המוצר.
identifier_exists

bool

יש להגדיר את הערך הזה כ-False אם לפריט אין מזהי מוצר ייחודיים (UPI) שמתאימים לקטגוריה שלו, כמו מספר פריט מסחרי גלובלי (GTIN), קוד MPN ומותג. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא True.
is_bundle

bool

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

string

שם הפריט.
description

string

תיאור הפריט.
adult

bool

צריך להגדיר את הערך True אם הפריט מטורגט למבוגרים.
age_group

string

מטרגטים את קבוצת הגיל של הפריט.
availability

string

סטטוס הזמינות של הפריט.
brand

string

המותג של הפריט
color

string

צבע הפריט.
condition

string

מצב הפריט.
gender

string

מגדר היעד של הפריט.
google_product_category

string

הקטגוריה של הפריט ב-Google (מידע נוסף זמין בטקסונומיית המוצרים של Google). כששולחים שאילתות על מוצרים, השדה הזה יכיל את הערך שסופק על ידי המשתמש. בשלב זה אין דרך להחזיר את קטגוריות המוצרים ב-Google שהוקצו באופן אוטומטי דרך ה-API.
gtin

string

מספר הפריט המסחרי הגלובלי (GTIN) של הפריט.
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

משמש לקיבוץ פריטים באופן שרירותי. רק עבור אחוז מהמחיר להמרה, לא מומלץ אחרת.
ads_redirect

string

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

string

מזהה של פריט לקמפיינים של רימרקטינג דינמי.
display_ads_title

string

שם הפריט בקמפיינים של רימרקטינג דינמי.
display_ads_value

double

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

string

אפשרות האיסוף של הפריט.
pickup_sla

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

פרסום הפריט הזה יושהה באופן זמני.
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

ערך האישור (שנקרא גם class, רמה או ציון), למשל A+ , C, gold. האורך המרבי הוא 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

הערך המינימלי של מספר ממשי (float) של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 1.00.
max_value

float

הערך המקסימלי של מספר ממשי (float) של המאפיין הנתון. לדוגמה, למוצר טלוויזיה 100.00.
unit_code

string

יחידה של המאפיין הנתון. לדוגמה, 'פיקסלים' למוצר טלוויזיה. גודל המחרוזת המקסימלי הוא 256B.

DeleteProductInputRequest

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

שדות
name

string

חובה. שם המשאב של קלט המוצר למחיקה. פורמט: accounts/{account}/productInputs/{product}
data_source

string

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

FreeShippingThreshold

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

שדות
country

string

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

Price

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

GetProductRequest

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

שדות
name

string

חובה. שם המוצר לאחזור. פורמט: accounts/{account}/products/{product}

InsertProductInputRequest

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

שדות
parent

string

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

ProductInput

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

string

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

תשלומים

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

שדות
months

int64

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

Price

הסכום שהקונה צריך לשלם בכל חודש.
downpayment

Price

סכום המקדמה שהקונה צריך לשלם.
credit_type

string

סוג התשלומים. הערכים הנתמכים הם: * "finance" * "lease"

ListProductsRequest

בקשת הודעה ל-method ListProducts.

שדות
parent

string

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

int32

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

string

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

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

ListProductsResponse

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

שדות
products[]

Product

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

string

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

LoyaltyPoints

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

שדות
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

הקאשבק (cashback) שניתן להשתמש בו לרכישות עתידיות.
loyalty_points

int64

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

מוצר

המוצר המעובד, שנוצר מכמה [אמצעי קלט של מוצרים][[google.shopping.content.bundles.Products.ProductInput], לאחר החלת כללים ומקורות נתונים משלימים. המוצר המעובד הזה תואם למידע שמוצג בחשבון Merchant Center, במודעות שופינג ובפלטפורמות אחרות ב-Google. כל מוצר נוצר מפרטים של מקור נתונים ראשי אחד בלבד, מכמה מקורות נתונים משלימים. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיעברו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד המעודכן.

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

שדות
name

string

שם המוצר. פורמט: "{product.name=accounts/{account}/products/{product}}"
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

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

ProductDimension

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

שדות
value

double

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

string

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

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

string

מזהה. השם של קלט המוצר. פורמט: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
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'. מספר התווים המקסימלי לכל מאפיין מותאם אישית הוא 10240 (המספר הכולל של תווים הוא השם והערך). אפשר להגדיר עד 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

השדה Item LevelIssue של סטטוס המוצר.

שדות
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 תווים

ProductStructuredTitle

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

שדות
digital_source_type

string

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

string

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

ProductWeight

משקל המוצר.

שדות
value

double

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

string

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

משלוח

משלוח המוצר.

שדות
price

Price

מחיר משלוח קבוע, מיוצג כמספר.
country

string

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

string

האזור הגיאוגרפי שעליו חל תעריף המשלוח. למידע נוסף, ראו אזור.
service

string

תיאור חופשי של רמת השירות או מהירות המסירה.
location_id

int64

המזהה המספרי של מיקום שעליו חל תעריף המשלוח, כפי שמוגדר ב-AdWords API.
location_group_name

string

המיקום שבו חל המשלוח, מיוצג על ידי שם של קבוצת מיקומים.
postal_code

string

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

int64

זמן טיפול מינימלי (כולל) בין מועד קבלת ההזמנה לבין שליחתה בימי עסקים. המשמעות של 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

int64

זמן הטיפול המקסימלי (כולל) מרגע קבלת ההזמנה ועד למשלוח בימי עסקים. המשמעות של 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

int64

זמן אספקה מינימלי (כולל) מרגע שליחת ההזמנה ועד למסירתה בימי עסקים. המשמעות של 0 היא שההזמנה נמסרת באותו יום שבו היא נשלחת. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] יכול להיות מוצג רק יחד עם [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time], אבל לא חובה אם המאפיין [maxTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] קיים.
max_transit_time

int64

זמן ההובלה המקסימלי (כולל) מרגע שליחת ההזמנה ועד למסירתה בימי עסקים. המשמעות של 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

double

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

string

יחידת הערך.

ShippingWeight

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

שדות
value

double

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

string

יחידת הערך.

SubscriptionCost

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

שדות
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

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

UnitPricingMeasure

יחידת התמחור של המוצר.

שדות
value

double

המידות של פריט.
unit

string

יחידת המידה.