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,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
שדות
lowPrice

object (Price)

מחיר הרצפה של המוצר בשירות ה-CSS.
highPrice

object (Price)

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

object (Price)

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

object (Price)

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

string

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

string

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

object (ProductDetail)

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

object (ProductWeight)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

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

object (Certification)

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

string (Timestamp format)

התאריך שבו תוקף הפריט יפוג, כפי שצוין בעת ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל מוצג ב-productstatuses כ-googleExpirationDate, ויכול להיות שהוא מוקדם יותר אם expirationDate חל מאוחר מדי בעתיד. הערה: יכולים לחלוף יומיים או יותר מתאריך התפוגה עד שהפריט יימחק בפועל.
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 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
reviewCount

string (int64 format)

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

string (int64 format)

ציון הדירוג המינימלי של המוצר. חובה אם צוין הערך rating. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.
maxRating

string (int64 format)

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

number

ציון הדירוג הממוצע של המוצר. הערך חייב להיות בטווח [minRating, maxRating], כולל. כשדירוג המוצר מוצג בדף המוצר, הוא עובר נרמול לסקאלה של [1, 5] עם ספרה אחת אחרי הנקודה העשרונית. אם מציינים את המאפיין הזה, צריך לציין גם את המאפיינים reviewCount,‏ minRating ו-maxRating. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.

מחיר

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

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

string (int64 format)

המחיר מיוצג כמספר במיקרו (מיליון מיקרו שווה ליחידה סטנדרטית של המטבע, לדוגמה, 1 דולר ארה"ב = מיליון מיקרו).
currencyCode

string

המטבע של המחיר באמצעות ראשי תיבות בני 3 אותיות לפי 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

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

ייצוג ב-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.