REST Resource: accounts.cssProducts

משאב: CssProduct

המוצר בשירות CSS שעבר עיבוד.

ייצוג ב-JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
שדות
name

string

השם של מוצר ה-CSS. פורמט: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

פלט בלבד. המזהה הגולמי הייחודי של המוצר.
contentLanguage

string

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

string

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

object (Attributes)

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

object (CustomAttribute)

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

object (CssProductStatus)

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

מאפיינים

מאפיינים של מוצר בשירות CSS.

ייצוג ב-JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string
}
שדות
lowPrice

object (Price)

מחיר נמוך של מוצר ה-CSS.
highPrice

object (Price)

מחיר גבוה של מוצר ה-CSS.
headlineOfferPrice

object (Price)

המחיר המרכזי של המוצר בשירות ה-CSS.
headlineOfferShippingPrice

object (Price)

המחיר המרכזי של המוצר בשירות ה-CSS.
productTypes[]

string

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

string

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

object (ProductDetail)

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

object (ProductWeight)

משקל המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-2000 (כולל).
productLength

object (ProductDimension)

אורך המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
productWidth

object (ProductDimension)

רוחב המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
productHeight

object (ProductDimension)

גובה המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3000 (כולל).
productHighlights[]

string

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

object (Certification)

רשימה של אישורים שהוצהרו על ידי שירות ה-CSS לגבי המוצר הנתון.
expirationDate

string (Timestamp format)

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

string

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

string

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

object (HeadlineOfferInstallment)

מספר התשלומים וסכומן לרכישת פריט.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

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

string

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

string (int64 format)

מספר המוצרים בשירות CSS.
headlineOfferCondition

string

המצב של המוצר המרכזי בדף.
title

string

השם של הפריט.
description

string

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

string

מאפיינים שקשורים למוצר.‏[14-36] המותג של הפריט.
mpn

string

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

string

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

string

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

boolean

מגדירים את הערך כ-true אם הפריט מיועד למבוגרים.
multipack

string (int64 format)

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

boolean

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

string

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

string

צבע הפריט.
gender

string

המגדר שאליו מיועד הפריט.
material

string

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

string

הדוגמה של הפריט (למשל, נקודות).
size

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

מחיר

המחיר מיוצג כמספר וכמטבע.

ייצוג ב-JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
שדות
amountMicros

string (int64 format)

המחיר מיוצג כמספר ב-micros (מיליון micros שווה ליחידה הרגילה של המטבע, לדוגמה, 1 USD = 1000000 micros).
currencyCode

string

המטבע של המחיר באמצעות ראשי תיבות של שלוש אותיות בהתאם לתקן ISO 4217.

ProductDetail

פרטי המוצר.

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

string

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

string

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

string

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

ProductWeight

משקל המוצר.

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

number

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

string

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

ProductDimension

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

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

number

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

string

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

הסמכה

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

ייצוג ב-JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
שדות
name

string

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

string

הרשות או הגוף שאחראים על הנפקת האישורים. נכון לעכשיו, הערך הנפוץ ביותר הוא 'EC' או 'European_Commission' לתוויות אנרגיה באיחוד האירופי.
code

string

הקוד של האישור. לדוגמה, אם הקישור לאישור EPREL הוא https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, הקוד הוא 123456. חובה לציין את הקוד כשמשתמשים בתוויות האנרגיה האירופיות.

HeadlineOfferInstallment

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

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

string (int64 format)

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

object (Price)

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

object (Price)

סכום המקדמה שעל הקונה לשלם מראש.

HeadlineOfferSubscriptionCost

הערך של 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 מציין שתקופת המינוי היא שנה.

CustomAttribute

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

ייצוג ב-JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
שדות
groupValues[]

object (CustomAttribute)

מאפייני משנה בתוך קבוצת המאפיינים הזו. אם השדה groupValues לא ריק, השדה value חייב להיות ריק.
name

string

שם המאפיין.
value

string

הערך של המאפיין. אם השדה value לא ריק, השדה groupValues חייב להיות ריק.

CssProductStatus

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

ייצוג ב-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 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
שדות
destination

string

שם היעד
approvedCountries[]

string

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

string

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

string

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

ItemLevelIssue

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

ייצוג ב-JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
שדות
code

string

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

string

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

string

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

string

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

string

היעד שאליו רלוונטית הבעיה.
description

string

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

string

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

string

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

string

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

Methods

get

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

list

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