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 (לא כולל) ל-2,000 (כולל).

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.

הערכים הנתמכים הם: - css_ads_experiences - css_organic_experiences

excludedDestinations[]

string

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

הערכים הנתמכים הם: - css_ads_experiences - css_organic_experiences

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 דולר ארה"ב = 1,000,000 מיקרו).

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

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

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

הבעיה ברמת הפריט (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.