REST Resource: accounts.products

משאב: מוצר

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

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

ייצוג JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
שדות
name

string

שם המוצר. פורמט: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

פלט בלבד. הערוץ של המוצר.
offerId

string

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

string

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

string

פלט בלבד. תווית הפיד של המוצר.
dataSource

string

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

object (Attributes)

פלט בלבד. רשימה של מאפייני מוצרים.
customAttributes[]

object (CustomAttribute)

פלט בלבד. רשימה של מאפיינים מותאמים אישית (שהמוכר סיפק). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הנתונים בגרסה הכללית (לדוגמה, { "name": "size type", "value": "regular" }). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפו במפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים את 'קונים ב-Google'.
productStatus

object (ProductStatus)

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

string (int64 format)

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

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

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

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

מאפיינים

מאפיינים.

ייצוג JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
שדות
expirationDate

string (Timestamp format)

התאריך שבו הפריט יפוג, כפי שצוין בזמן ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל ייחשף ב-productstatuses בתור googleExpirationDate ועשוי להיות מוקדם יותר אם expirationDate חל במועד רחוק מדי.
disclosureDate

string (Timestamp format)

התאריך שבו מוצר מופיע בתוצאות חיפוש בפלטפורמות YouTube של Google, בפורמט ISO 8601. מידע נוסף זמין בקטע [תאריך החשיפה]( https://support.google.com/merchants/answer/13034208).
availabilityDate

string (Timestamp format)

ביום שבו מוצר שמוזמן מראש יהיה זמין למשלוח, בפורמט ISO 8601.
price

object (Price)

מחיר הפריט.
installment

object (Installment)

מספר התשלומים על פריט וסכום התשלומים.
subscriptionCost

object (SubscriptionCost)

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

object (LoyaltyPoints)

נקודות מועדון שמשתמשים מקבלים אחרי רכישת הפריט. ביפן בלבד.
loyaltyPrograms[]

object (LoyaltyProgram)

רשימה של מידע על מועדון הלקוחות שמשמשת כדי להציג למשתמשים של הפריט הזה הטבות לחברי מועדון (למשל, מחירים טובים יותר, נקודות וכו').
productTypes[]

string

קטגוריות הפריט (בפורמט של מפרט נתוני המוצרים).
salePrice

object (Price)

מחיר המבצע שפורסם על הפריט.
salePriceEffectiveDate

object (Interval)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

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

object (Shipping)

כללי משלוח.
freeShippingThreshold[]

object (FreeShippingThreshold)

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

object (ShippingWeight)

משקל הפריט למשלוח.
shippingLength

object (ShippingDimension)

אורך הפריט למשלוח.
shippingWidth

object (ShippingDimension)

רוחב הפריט במשלוח.
shippingHeight

object (ShippingDimension)

גובה הפריט למשלוח.
sizeTypes[]

string

הגזרה של הפריט. אפשר להשתמש בו כדי לייצג סוגי מידות משולבים לפריטי לבוש. אפשר לציין שני סוגי מידות לכל היותר (מידע נוסף זמין בכתובת [https://support.google.com/merchants/answer/6324497](size type)).
taxes[]

object (Tax)

פרטי המס.
unitPricingMeasure

object (UnitPricingMeasure)

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

object (UnitPricingBaseMeasure)

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

string

דומה ל-adsGrouping, אבל פועל רק לפי עלות לקליק.
costOfGoodsSold

object (Price)

עלות המכר. משמש לדיווח על הרווח ברוטו.
productDetails[]

object (ProductDetail)

מפרט טכני או פרטים נוספים על המוצר.
productHighlights[]

string

נקודות בולטות שמתארות את הפרטים החשובים ביותר של המוצר.
displayAdsSimilarIds[]

string

המלצות שצוינו על ידי המפרסם.
promotionIds[]

string

המזהה הייחודי של מבצע.
includedDestinations[]

string

רשימת היעדים שצריך לכלול בשביל היעד הזה (הרשימה תואמת לתיבות שמסומנות ב-Merchant Center). יעדי ברירת מחדל תמיד נכללים, אלא אם צוינו ב-excludedDestinations.
excludedDestinations[]

string

רשימת היעדים שצריך להחריג בשביל היעד הזה (הרשימה תואמת לתיבות שלא מסומנות ב-Merchant Center).
shoppingAdsExcludedCountries[]

string

רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם מצוין המוצר להחרגה מהיעד של מודעות שופינג. מדינות מהרשימה הזו יוסרו ממדינות שהוגדרו בהגדרות של מקור הנתונים.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

שדות נוספים לייצוא לתוכנית Cloud Retail.
certifications[]

object (Certification)

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

object (Price)

אמצעי הגנה בפרויקטים 'הנחות אוטומטיות' (https://support.google.com/merchants/answer/10295759) ו'מבצעים דינמיים' (https://support.google.com/merchants/answer/13949249), כדי להבטיח שההנחות על מוצרים של מוכרים לא יהיו מתחת לערך הזה, וכך לשמור על הערך והרווחיות של המוצר.
identifierExists

boolean

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

boolean

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

string

שם הפריט.
description

string

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

boolean

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

string

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

string

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

string

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

string

צבע הפריט.
condition

string

מצב הפריט.
gender

string

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

string

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

string

מספר הפריט המסחרי הגלובלי (GTIN) של הפריט.
itemGroupId

string

מזהה משותף לכל הווריאציות של אותו מוצר.
material

string

החומר שממנו עשוי הפריט.
mpn

string

מספר החלק שהיצרן הקצה לפריט (MPN).
pattern

string

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

string (int64 format)

כמות המוצרים שזמינים למכירה ב-Google. נתמך רק במוצרים שנמכרים אונליין.
maxHandlingTime

string (int64 format)

זמן טיפול מקסימלי במוצר (בימי עסקים).
minHandlingTime

string (int64 format)

זמן טיפול מינימלי במוצר (בימי עסקים).
shippingLabel

string

תווית המשלוח של המוצר, שמשמשת לקיבוץ המוצר בכללי משלוח ברמת החשבון.
transitTimeLabel

string

תווית זמן ההובלה של המוצר, שמשמשת לקיבוץ המוצר בטבלאות זמן הובלה ברמת החשבון.
size

string

גודל הפריט. מותר להשתמש בערך אחד בלבד. לווריאציות במידות שונות, צריך להזין מוצר נפרד לכל מידה עם אותו ערך itemGroupId (מידע נוסף זמין בכתובת [https://support.google.com/merchants/answer/6324492](הגדרת גודל)).
sizeSystem

string

מערכת שבה הגודל שצוין. מומלץ לפריטי לבוש.
taxCategory

string

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

string

סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
minEnergyEfficiencyClass

string

סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
maxEnergyEfficiencyClass

string

סיווג היעילות האנרגטית כפי שמוגדר בהנחיה 2010/30/EU של האיחוד האירופי.
multipack

string (int64 format)

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

string

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

string

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

string

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

string

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

number

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

string

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

string

ציר הזמן לאיסוף הפריט מהחנות.
customLabel0

string

תווית מותאמת אישית 0 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
customLabel1

string

תווית מותאמת אישית 1 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
customLabel2

string

תווית מותאמת אישית 2 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
customLabel3

string

תווית מותאמת אישית 3 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
customLabel4

string

תווית מותאמת אישית 4 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
externalSellerId

string

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

string

פרסום הפריט הזה יושהה באופן זמני.
structuredTitle

object (ProductStructuredTitle)

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

object (ProductStructuredDescription)

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

תשלומים

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

ייצוג JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
שדות
months

string (int64 format)

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

object (Price)

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

object (Price)

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

string

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

SubscriptionCost

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

ייצוג JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
שדות
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

object (Price)

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

SubscriptionPeriod

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

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

LoyaltyPoints

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

ייצוג JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
שדות
name

string

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

string (int64 format)

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

number

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

LoyaltyProgram

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

ייצוג JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
שדות
programLabel

string

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

string

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

object (Price)

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

object (Price)

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

string (int64 format)

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

ProductDimension

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

ייצוג JSON 
{
  "value": number,
  "unit": string
}
שדות
value

number

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

string

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

ProductWeight

משקל המוצר.

ייצוג JSON 
{
  "value": number,
  "unit": string
}
שדות
value

number

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

string

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

משלוח

משלוח המוצר.

ייצוג JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
שדות
price

object (Price)

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

FreeShippingThreshold

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

ייצוג JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
שדות
country

string

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

object (Price)

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

ShippingWeight

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

ייצוג JSON 
{
  "value": number,
  "unit": string
}
שדות
value

number

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

string

יחידת הערך.

ShippingDimension

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

ייצוג JSON 
{
  "value": number,
  "unit": string
}
שדות
value

number

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

string

יחידת הערך.

מס

המס על המוצר.

ייצוג JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
שדות
rate

number

אחוז שיעור המס שחל על מחיר הפריט.
country

string

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

string

האזור הגיאוגרפי ששיעור המס חל עליו.
taxShip

boolean

צריך להגדיר את הערך True אם גובים מס על המשלוח.
locationId

string (int64 format)

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

string

טווח המיקודים ששיעור המס חל עליו, מיוצג על ידי מיקוד, קידומת של מיקוד עם תו כללי לחיפוש *, טווח בין שני מיקודים או שתי קידומות של מיקוד באורך זהה. לדוגמה: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

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

ייצוג JSON 
{
  "value": number,
  "unit": string
}
שדות
value

number

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

string

יחידת המידה.

UnitPricingBaseMeasure

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

ייצוג JSON 
{
  "value": string,
  "unit": string
}
שדות
value

string (int64 format)

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

string

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

ProductDetail

פרטי המוצר.

ייצוג JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
שדות
sectionName

string

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

string

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

string

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

CloudExportAdditionalProperties

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

ייצוג JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
שדות
textValue[]

string

ערך הטקסט של המאפיין הנתון. לדוגמה, '8K(UHD)' יכול להיות ערך טקסט של מוצר טלוויזיה. מספר החזרות המקסימלי של הערך הזה הוא 400. הערכים מאוחסנים בסדר שרירותי ועקבי. גודל המחרוזת המקסימלי הוא 256 תווים.
intValue[]

string (int64 format)

ערכי מספר שלם של המאפיין הנתון. לדוגמה: 1080 לרזולוציית מסך של מוצר טלוויזיה. מספר החזרות המקסימלי של הערך הזה הוא 400. הערכים מאוחסנים בסדר שרירותי ועקבי.
floatValue[]

number

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

string

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

boolean

ערך בוליאני של הנכס הנתון. לדוגמה עבור מוצר טלוויזיה, יש להזין את הערך 'True' או 'False' אם המסך הוא באיכות UHD.
minValue

number

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

number

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

string

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

אישור

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

ייצוג JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
שדות
certificationAuthority

string

רשות האישורים, לדוגמה European_Commission. האורך המרבי הוא 2,000 תווים.
certificationName

string

שם האישור, לדוגמה EPREL. האורך המרבי הוא 2,000 תווים.
certificationCode

string

קוד האישור. האורך המרבי הוא 2,000 תווים.
certificationValue

string

ערך האישור (שנקרא גם class, רמה או ציון), למשל A+ , C, gold. האורך המרבי הוא 2,000 תווים.

ProductStructuredTitle

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

ייצוג JSON 
{
  "digitalSourceType": string,
  "content": string
}
שדות
digitalSourceType

string

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

string

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

ProductStructuredDescription

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

ייצוג JSON 
{
  "digitalSourceType": string,
  "content": string
}
שדות
digitalSourceType

string

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

string

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

ProductStatus

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

ייצוג JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
שדות
destinationStatuses[]

object (DestinationStatus)

היעדים המיועדים של המוצר.
itemLevelIssues[]

object (ItemLevelIssue)

רשימה של כל הבעיות שמשויכות למוצר הזה.
creationDate

string (Timestamp format)

התאריך שבו הפריט נוצר, בפורמט ISO 8601.
lastUpdateDate

string (Timestamp format)

התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601.
googleExpirationDate

string (Timestamp format)

התאריך שבו תוקף הפריט פג, בפורמט ISO 8601.

DestinationStatus

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

ייצוג JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
שדות
reportingContext

enum (ReportingContextEnum)

השם של הקשר הדיווח.
approvedCountries[]

string

רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהן המוצר מאושר.
pendingCountries[]

string

רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם המוצר בהמתנה לאישור.
disapprovedCountries[]

string

רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם המוצר נפסל.

ItemLevelIssue

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

ייצוג JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
שדות
code

string

קוד השגיאה של הבעיה.
severity

enum (Severity)

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

string

האם המוכר יכול לפתור את הבעיה.
attribute

string

שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד.
reportingContext

enum (ReportingContextEnum)

ההקשר המדווח שאליו הבעיה מתייחסת.
description

string

תיאור קצר של הבעיה באנגלית.
detail

string

תיאור מפורט של הבעיה באנגלית.
documentation

string

כתובת ה-URL של דף אינטרנט שעוזר לפתור את הבעיה.
applicableCountries[]

string

רשימת קודי מדינות (ISO 3166-1 alpha-2) שבהם הבעיה רלוונטית למוצר.

מידת החומרה

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

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

שיטות

get

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

list

 בתיבת הדו-שיח הזו מפורטים המוצרים המעובדים בחשבון Merchant Center שלכם.