עד יוני 2026, נדרוש רישום חובה של מפתחים ב-CSS API. כדי לשפר את היציבות והאבטחה של ממשקי ה-API, אנחנו משיקים רישום חד-פעמי חובה לממשקי ה-API של שירותי ה-CSS. אם כבר ביצעתם את ההרשמה הזו לפרויקטים שלכם ב-Google Cloud במהלך הפעלת Merchant API, לא תצטרכו לחזור על השלבים האלה. הוראות מפורטות יותר זמינות באתר למפתחים של Merchant API. אם דרושה עזרה נוספת, אפשר לפנות אל צוות התמיכה של API.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Package google.shopping.css.v1

אינדקס

‫AccountLabelsService (ממשק)
‫AccountsService (ממשק)
‫CssProductInputsService (ממשק)
‫CssProductsService (ממשק)
‫QuotaService (ממשק)
‫Account (הודעה)
Account.AccountType (enum)
‫AccountLabel (הודעה)
AccountLabel.LabelType (enum)
‫Attributes (הודעה)
‫Certification (הודעה)
‫CreateAccountLabelRequest (הודעה)
‫CssProduct (הודעה)
‫CssProductInput (הודעה)
‫CssProductStatus (הודעה)
‫CssProductStatus.DestinationStatus (הודעה)
‫CssProductStatus.ItemLevelIssue (הודעה)
‫DeleteAccountLabelRequest (הודעה)
‫DeleteCssProductInputRequest (הודעה)
‫GetAccountRequest (הודעה)
‫GetCssProductRequest (הודעה)
‫HeadlineOfferInstallment (הודעה)
‫HeadlineOfferSubscriptionCost (הודעה)
‫InsertCssProductInputRequest (הודעה)
‫ListAccountLabelsRequest (הודעה)
‫ListAccountLabelsResponse (הודעה)
‫ListChildAccountsRequest (הודעה)
‫ListChildAccountsResponse (הודעה)
‫ListCssProductsRequest (הודעה)
‫ListCssProductsResponse (הודעה)
‫ListQuotaGroupsRequest (הודעה)
‫ListQuotaGroupsResponse (הודעה)
‫MethodDetails (הודעה)
‫ProductDetail (הודעה)
‫ProductDimension (הודעה)
‫ProductWeight (הודעה)
‫QuotaGroup (הודעה)
SubscriptionPeriod (enum)
‫UpdateAccountLabelRequest (הודעה)
‫UpdateAccountLabelsRequest (הודעה)
‫UpdateCssProductInputRequest (הודעה)

AccountLabelsService

ניהול תוויות של חשבונות Merchant Center ו-CSS.

CreateAccountLabel

CreateAccountLabel
`rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)` יוצר תווית חדשה שלא משויכת לאף חשבון. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

יוצר תווית חדשה שלא משויכת לאף חשבון.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

DeleteAccountLabel

DeleteAccountLabel
`rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)` מוחק תווית ומסיר אותה מכל החשבונות שהיא הוקצתה להם. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

ListAccountLabels

ListAccountLabels
`rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)` רשימה של התוויות שבבעלות החשבון. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

רשימה של התוויות שבבעלות החשבון.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

UpdateAccountLabel

UpdateAccountLabel
`rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)` עדכון של תווית. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

עדכון של תווית.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

AccountsService

שירות לניהול מידע על חשבונות CSS או חשבונות מרובי לקוחות.

GetAccount

GetAccount
`rpc GetAccount(GetAccountRequest) returns (Account)` מאחזר חשבון CSS או חשבון ניהול יחיד לפי מזהה. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc GetAccount(GetAccountRequest) returns (Account)

מאחזר חשבון CSS או חשבון ניהול יחיד לפי מזהה.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

ListChildAccounts

ListChildAccounts
`rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)` מציג רשימה של כל החשבונות שמשויכים למזהה חשבון ה-CSS שצוין, ויש אפשרות לסנן לפי מזהה תווית ושם חשבון. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

UpdateLabels

UpdateLabels
`rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)` העדכון מתבצע לתוויות שמוקצות לחשבונות CSS או לחשבונות MCA על ידי דומיין CSS. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

העדכון מתבצע לתוויות שמוקצות לחשבונות CSS או לחשבונות MCA על ידי דומיין CSS.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

CssProductInputsService

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

DeleteCssProductInput

DeleteCssProductInput
`rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)` מחיקת קלט מוצר CSS מחשבון CSS Center. אחרי המחיקה, יכול להיות שיחלפו כמה דקות עד שהקלט לא יהיה יותר זמין. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

מחיקת קלט מוצר CSS מחשבון CSS Center.

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

InsertCssProductInput

InsertCssProductInput
`rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)` העלאה של CssProductInput לחשבון שלכם ב-CSS Center. אם כבר קיים קלט עם אותם ערכים של contentLanguage, ‏ identity, ‏ feedLabel ו-feedId, השיטה הזו מחליפה את הרשומה הזו. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר CSS, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את מוצר ה-CSS המעובד. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

העלאה של CssProductInput לחשבון שלכם ב-CSS Center. אם כבר קיים קלט עם אותם ערכים של contentLanguage, ‏ identity, ‏ feedLabel ו-feedId, השיטה הזו מחליפה את הרשומה הזו.

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

UpdateCssProductInput

UpdateCssProductInput
`rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)` מערכת מעדכנת את קלט המוצר הקיים בשירות ה-CSS בחשבון שלכם ב-CSS Center. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר בשירות CSS, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד בשירות CSS. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

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

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

CssProductsService

שירות לביצוע פעולות get ו-list במוצרי CSS(שנקראים גם 'מבצעים מצטברים').

GetCssProduct

GetCssProduct
`rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)` מאחזר את מוצר ה-CSS שעבר עיבוד מחשבון CSS Center. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר הסופי המעודכן. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

ListCssProducts

ListCssProducts
`rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)` רשימה של מוצרי CSS שעברו עיבוד בחשבון CSS Center. יכול להיות שהתשובה תכיל פחות פריטים ממה שצוין ב-pageSize. כדאי להסתמך על pageToken כדי לקבוע אם יש עוד פריטים לבקשה. אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר בשירות CSS, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעודכן בשירות ה-CSS. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

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

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

QuotaService

שירות לקבלת מידע על מכסות של הפעלות method לכל שיטה ב-CSS API.

ListQuotaGroups

ListQuotaGroups
`rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)` בעמודה הזו מפורטים מכסת השיחות היומית והשימוש בכל קבוצה בחשבון CSS Center. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/content` ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

חשבון

מידע על חשבון CSS או חשבון מרובה לקוחות.

שדות
`name`	`string` שם המשאב של התווית. פורמט: accounts/{account}
`full_name`	`string` פלט בלבד. אי אפשר לשנות. השם המלא של חשבון ה-CSS או חשבון ה-MC.
`label_ids[]`	`int64` מזהי תוויות שנוצרו באופן ידני והוקצו לחשבון CSS או לחשבון MC על ידי חשבון ראשי של שירות CSS.
`automatic_label_ids[]`	`int64` מזהי תוויות שנוצרו באופן אוטומטי ומוקצים לחשבון ה-MC על ידי CSS Center.
`account_type`	`AccountType` פלט בלבד. סוג החשבון.
`display_name`	`string` השם המוצג הקצר של חשבון ה-CSS או חשבון הניהול.
`homepage_uri`	`string` פלט בלבד. אי אפשר לשנות. דף הבית של חשבון ה-CSS או ה-MCA.
`parent`	`string` משאב האב של חשבון ה-CSS או ה-MCA. קבוצת CSS לדומיינים של CSS; דומיין CSS לחשבונות MCA. הערך הזה מוחזר רק אם למשתמש יש גישה לחשבון ההורה. הערה: בחשבונות משנה של MC, זהו גם דומיין ה-CSS שהוא משאב האב של חשבון ה-MCA, כי אנחנו משטחים למעשה את ההיררכיה".

AccountType

סוג החשבון.

טיפוסים בני מנייה (enum)
`ACCOUNT_TYPE_UNSPECIFIED`	סוג החשבון לא ידוע.
`CSS_GROUP`	חשבון של קבוצת CSS.
`CSS_DOMAIN`	חשבון דומיין CSS.
`MC_PRIMARY_CSS_MCA`	חשבון MCA ראשי של שירות CSS.
`MC_CSS_MCA`	חשבון MCA של שירות CSS מרובה לקוחות.
`MC_MARKETPLACE_MCA`	חשבון MCA בזירת מסחר.
`MC_OTHER_MCA`	חשבון MC אחר של MCA.
`MC_STANDALONE`	חשבון MC עצמאי.
`MC_MCA_SUBACCOUNT`	חשבון משנה של MCA בחשבון MC.

AccountLabel

תווית שמוקצית על ידי דומיין CSS או קבוצת CSS לאחד מחשבונות המשנה שלה.

שדות
`name`	`string` מזהה. שם המשאב של התווית. פורמט: accounts/{account}/labels/{label}
`label_id`	`int64` פלט בלבד. המזהה של התווית.
`account_id`	`int64` פלט בלבד. המזהה של החשבון שאליו שייכת התווית.
`label_type`	`LabelType` פלט בלבד. סוג התווית.
`display_name`	`string` השם המוצג של התווית.
`description`	`string` התיאור של התווית.

LabelType

סוג התווית.

טיפוסים בני מנייה (enum)
`LABEL_TYPE_UNSPECIFIED`	סוג התווית לא ידוע.
`MANUAL`	מציין שהתווית נוצרה באופן ידני.
`AUTOMATIC`	מציין שהתווית נוצרה באופן אוטומטי על ידי CSS Center.

מאפיינים

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

שדות
`low_price`	`Price` מחיר הרצפה של המוצר בשירות ה-CSS.
`high_price`	`Price` מחיר גבוה של מוצר בשירות CSS.
`headline_offer_price`	`Price` מחיר המוצר המרכזי בדף המוצר בשירות ה-CSS.
`headline_offer_shipping_price`	`Price` מחיר המוצר המרכזי בדף המוצר בשירות ה-CSS.
`additional_image_links[]`	`string` כתובות URL נוספות של תמונות של הפריט.
`product_types[]`	`string` קטגוריות הפריט (בפורמט שמופיע במפרט נתוני המוצרים).
`size_types[]`	`string` הגזרה של הפריט. אפשר להשתמש בו כדי לייצג סוגי מידות משולבים של פריטי לבוש. אפשר לציין עד שני סוגי מידות (ראו סוג מידה).
`product_details[]`	`ProductDetail` מפרט טכני של המוצר או פרטי המוצר נוספים.
`product_weight`	`ProductWeight` משקל המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-2000 (כולל).
`product_length`	`ProductDimension` אורך המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל).
`product_width`	`ProductDimension` רוחב המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל).
`product_height`	`ProductDimension` גובה המוצר ביחידות שצוינו. הערך חייב להיות בין 0 (לא כולל) ל-3,000 (כולל).
`product_highlights[]`	`string` נקודות עם תיאור של הפרטים החשובים והרלוונטיים ביותר לגבי המוצר.
`certifications[]`	`Certification` רשימה של אישורים שהוגשו על ידי שירות ה-CSS עבור המוצר הנתון.
`expiration_date`	`Timestamp` התאריך שבו תוקף הפריט יפוג, כפי שצוין בעת ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל מוצג ב-`productstatuses` כ-googleExpirationDate, ויכול להיות שהוא מוקדם יותר אם `expirationDate` חל מאוחר מדי בעתיד. הערה: יכולים לחלוף יומיים או יותר מתאריך התפוגה עד שהפריט יימחק בפועל.
`included_destinations[]`	`string` רשימת היעדים שצריך לכלול בשביל היעד הזה (הרשימה תואמת לתיבות שמסומנות ב-Merchant Center). יעדי ברירת מחדל תמיד נכללים, אלא אם צוינו ב-`excludedDestinations`.
`excluded_destinations[]`	`string` רשימת היעדים שצריך להחריג בשביל היעד הזה (הרשימה תואמת לתיבות שלא מסומנות ב-Merchant Center).
`headline_offer_installment`	`HeadlineOfferInstallment` מספר התשלומים וסכום כל תשלום שצריך לשלם על פריט.
`headline_offer_subscription_cost`	`HeadlineOfferSubscriptionCost` מספר התקופות (חודשים או שנים) וסכום התשלום לכל תקופה של פריט עם חוזה מינוי משויך.
`cpp_link`	`string` כתובת URL שמקשרת ישירות לדף פרטי המוצר בשירות ה-CSS.
`cpp_mobile_link`	`string` כתובת ה-URL של הגרסה שמותאמת לניידים של דף פרטי המוצר בשירות ה-CSS.
`cpp_ads_redirect`	`string` המפרסמים יכולים לשנות את כתובת ה-URL של הפריט כשהמוצר מוצג בהקשר של מודעות מוצרים.
`number_of_offers`	`int64` מספר המוצרים בשירות ה-CSS.
`headline_offer_condition`	`string` מצב המוצר המרכזי בדף.
`headline_offer_link`	`string` קישור למוצר המרכזי בדף.
`headline_offer_mobile_link`	`string` קישור שמותאם לניידים למוצר המרכזי בדף.
`title`	`string` השם של הפריט.
`image_link`	`string` כתובת URL של תמונת הפריט.
`description`	`string` תיאור הפריט.
`brand`	`string` מאפיינים שקשורים למוצר.[14-36] המותג של הפריט.
`mpn`	`string` MPN.
`gtin`	`string` מספר פריט מסחרי גלובלי (GTIN) של הפריט.
`google_product_category`	`string` הקטגוריה של הפריט ב-Google (ראו טקסונומיית המוצרים של Google). כשמבצעים שאילתה על מוצרים, השדה הזה יכיל את הערך שהמשתמש סיפק. נכון לעכשיו, אין דרך לקבל בחזרה את קטגוריות המוצרים ב-Google שהוקצו באופן אוטומטי באמצעות ה-API.
`adult`	`bool` הערך שמוגדר הוא true אם הפריט מיועד למבוגרים.
`multipack`	`int64` מספר המוצרים הזהים במארז של כמה יחידות, לפי הגדרת המוכר.
`is_bundle`	`bool` האם הפריט הוא חבילה שהמוכר הגדיר. חבילה היא קבוצה מותאמת אישית של מוצרים שונים שנמכרים על ידי מוכר במחיר אחד.
`age_group`	`string` קבוצת הגיל שאליה מיועד הפריט.
`color`	`string` צבע הפריט.
`gender`	`string` המגדר שאליו מיועד הפריט.
`material`	`string` החומר שממנו עשוי הפריט.
`pattern`	`string` הדוגמה של הפריט (למשל, נקודות).
`size`	`string` מידת הפריט. מותר להשתמש רק בערך אחד. לגבי וריאציות עם מידות שונות, צריך להוסיף מוצר נפרד לכל מידה עם אותו ערך `itemGroupId` (ראו [https://support.google.com/merchants/answer/6324492](הגדרת מידה)).
`size_system`	`string` שיטת המידות שבה מצוינת המידה. מומלץ לפריטי לבוש.
`item_group_id`	`string` מזהה משותף לכל הווריאציות של אותו מוצר.
`pause`	`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 לקיבוץ מותאם אישית של פריטים בקמפיין שופינג.
`review_count`	`int64` מספר הביקורות על המוצר. חובה אם צוין הערך `rating`. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.
`min_rating`	`int64` ציון הדירוג המינימלי של המוצר. חובה אם צוין הערך `rating`. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.
`max_rating`	`int64` ציון הדירוג המקסימלי של המוצר. חובה אם צוין הערך `rating`. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.
`rating`	`double` ציון הדירוג הממוצע של המוצר. הערך חייב להיות בטווח [`min_rating`, `max_rating`], כולל. כשדירוג המוצר מוצג בדף המוצר, הוא עובר נרמול לסקאלה של [1, 5] עם ספרה אחת אחרי הנקודה העשרונית. אם מציינים את המאפיין הזה, צריך לציין גם את המאפיינים `review_count`,‏ `min_rating` ו-`max_rating`. השדה הזה מיועד לתכונה עתידית ועדיין לא נמצא בשימוש.

הסמכה

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

שדות

שדות
`name`	`string` שם האישור. בשלב הזה, הערך הנפוץ ביותר הוא EPREL, שמייצג אישורי יעילות אנרגטית במסד הנתונים של המרשם האירופי לסימון יעילות אנרגטית (EPREL) באיחוד האירופי.
`authority`	`string` הרשות או הגוף שאחראים על הנפקת האישורים. בשלב הזה, הערך הנפוץ ביותר הוא EC או European_Commission לתוויות אנרגיה באיחוד האירופי.
`code`	`string` קוד האישור. למשל, אם הקישור לאישור EPREL הוא https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, הקוד הוא 123456. חובה לציין את הקוד כשמשתמשים בתוויות האנרגיה האירופיות.

name

string

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

authority

string

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

code

string

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

CreateAccountLabelRequest

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

שדות

שדות
`parent`	`string` חובה. חשבון ההורה. פורמט: accounts/{account}
`account_label`	`AccountLabel` חובה. התווית שרוצים ליצור.

parent

string

חובה. חשבון ההורה. פורמט: accounts/{account}

account_label

AccountLabel

חובה. התווית שרוצים ליצור.

CssProduct

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

שדות
`name`	`string` השם של מוצר ה-CSS. פורמט: `"accounts/{account}/cssProducts/{css_product}"`
`raw_provided_id`	`string` פלט בלבד. המזהה הייחודי הגולמי של המוצר.
`content_language`	`string` פלט בלבד. קוד השפה של המוצר בן שתי אותיות לפי תקן ISO 639-1.
`feed_label`	`string` פלט בלבד. תווית הפיד של המוצר.
`attributes`	`Attributes` פלט בלבד. רשימה של מאפייני מוצרים.
`custom_attributes[]`	`CustomAttribute` פלט בלבד. רשימה של מאפיינים מותאמים אישית (שמסופקים על ידי שירות CSS). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הפיד בצורה הגנרית שלו (לדוגמה, `{ "name": "size type", "value": "regular" }`). זה שימושי לשליחת מאפיינים שלא נחשפים באופן מפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים ל'קונים ב-Google'.
`css_product_status`	`CssProductStatus` פלט בלבד. הסטטוס של מוצר, בעיות באימות נתונים, כלומר מידע על מוצר שמחושב באופן אסינכרוני.

CssProductInput

המשאב הזה מייצג את נתוני הקלט שאתם שולחים למוצר CSS, ולא את מוצר ה-CSS המעובד שמוצג ב-CSS Center, במודעות שופינג או בפלטפורמות השונות של Google.

שדות
`name`	`string` מזהה. השם של קלט המוצר של שירות השוואת המחירים. פורמט: `accounts/{account}/cssProductInputs/{css_product_input}`, כאשר החלק האחרון `css_product_input` מורכב מ-3 חלקים: contentLanguage~feedLabel~offerId. דוגמה: accounts/123/cssProductInputs/de~DE~rawProvidedId123
`final_name`	`string` פלט בלבד. השם של מוצר CSS שעבר עיבוד. פורמט: `accounts/{account}/cssProducts/{css_product}` "
`raw_provided_id`	`string` חובה. המזהה הייחודי של המוצר של שירות השוואת המחירים. הדבר נכון גם לגבי קלט המוצר בשירות ה-CSS ולגבי המוצר בשירות ה-CSS שעבר עיבוד. אנחנו מאפשרים להשתמש רק במזהים עם תווים אלפאנומריים, קווים תחתונים ומקפים. פרטים נוספים זמינים במפרט פיד המוצרים.
`content_language`	`string` חובה. קוד השפה של המוצר בשירות ה-CSS, בן 2 אותיות לפי תקן ISO 639-1.
`feed_label`	`string` חובה. תווית הפיד של מוצר ה-CSS. תווית הפיד היא מילה נרדפת ל'מדינת היעד', ולכן היא תמיד צריכה להיות קוד אזור תקין. לדוגמה: 'DE' לגרמניה, 'FR' לצרפת.
`freshness_time (deprecated)`	`Timestamp` הפריט הזה יצא משימוש. יצא משימוש. במקום זאת, צריך להשתמש במאפיין expiration_date [תאריך_תפוגה]. מייצג את הגרסה הקיימת (העדכנית) של מוצר ה-CSS, שאפשר להשתמש בה כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אסור להגדיר בשדה הזה תאריך עתידי. אם הגדרתם את התכונה הזו, המערכת לא תבצע את העדכון אם כבר קיימת גרסה חדשה יותר של הפריט במערכת שלנו (כלומר, אם שעת העדכון האחרון של המוצרים הקיימים בשירות ה-CSS מאוחרת יותר משעת הרענון שהגדרתם בעדכון). אם העדכון מתבצע, השעה של העדכון האחרון מוגדרת לשעת הרענון הזו. אם לא מגדירים את הערך הזה, העדכון לא יימנע וזמן העדכון האחרון יהיה כברירת מחדל הזמן שבו הבקשה הזו התקבלה על ידי CSS API. אם הפעולה נמנעת, יופעל חריג של ביטול.
`attributes`	`Attributes` רשימה של מאפייני מוצרים בשירות CSS.
`custom_attributes[]`	`CustomAttribute` רשימה של מאפיינים מותאמים אישית (שמסופקים על ידי שירות CSS). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הפיד בצורה הגנרית שלו (לדוגמה: `{ "name": "size type", "value": "regular" }`). זה שימושי לשליחת מאפיינים שלא נחשפים באופן מפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים ב'קונים ב-Google'.

CssProductStatus

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

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

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

שדות
`destination`	`string` שם היעד
`approved_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן המוצר של שירות ה-CSS אושר.
`pending_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן המוצר של שירות ה-CSS ממתין לאישור.
`disapproved_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן המוצר של שירות ה-CSS נפסל.

ItemLevelIssue

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

שדות
`code`	`string` קוד השגיאה של הבעיה.
`servability`	`string` איך הבעיה הזו משפיעה על הצגת המוצרים של שירות ה-CSS.
`resolution`	`string` אם המוֹכר יכול לפתור את הבעיה.
`attribute`	`string` שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד.
`destination`	`string` היעד שאליו מתייחסת הבעיה.
`description`	`string` תיאור קצר של הבעיה באנגלית.
`detail`	`string` תיאור מפורט של הבעיה באנגלית.
`documentation`	`string` כתובת ה-URL של דף אינטרנט שיכולה לעזור בפתרון הבעיה.
`applicable_countries[]`	`string` רשימה של קודי מדינות (ISO 3166-1 alpha-2) שבהן הבעיה רלוונטית למוצר CSS.

DeleteAccountLabelRequest

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

שדות

שדות
`name`	`string` חובה. השם של התווית שרוצים למחוק. פורמט: accounts/{account}/labels/{label}

name

string

חובה. השם של התווית שרוצים למחוק. פורמט: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

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

שדות

שדות
`name`	`string` חובה. השם של משאב הקלט של מוצר CSS שרוצים למחוק. הפורמט הוא: accounts/{account}/cssProductInputs/{css_product_input}, כאשר החלק האחרון `css_product_input` מורכב מ-3 חלקים: contentLanguage~feedLabel~offerId. דוגמה: accounts/123/cssProductInputs/de~DE~rawProvidedId123
`supplemental_feed_id`	`int64` מזהה הפיד המשלים ב-Content API. אסור להגדיר את השדה הזה אם הפעולה חלה על פיד ראשי. אם השדה מוגדר, פעולת המוצר חלה על פיד משלים במקום על פיד ראשי ב-Content API.

name

string

חובה. השם של משאב הקלט של מוצר CSS שרוצים למחוק. הפורמט הוא: accounts/{account}/cssProductInputs/{css_product_input}, כאשר החלק האחרון css_product_input מורכב מ-3 חלקים: contentLanguage~feedLabel~offerId. דוגמה: accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

מזהה הפיד המשלים ב-Content API. אסור להגדיר את השדה הזה אם הפעולה חלה על פיד ראשי. אם השדה מוגדר, פעולת המוצר חלה על פיד משלים במקום על פיד ראשי ב-Content API.

GetAccountRequest

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

שדות

שדות
`name`	`string` חובה. השם של חשבון ה-CSS או החשבון מרובה הלקוחות המנוהל. פורמט: accounts/{account}
`parent`	`string` אופציונלי. נדרש רק כשמאחזרים פרטים של חשבון מרובה ערוצים. דומיין ה-CSS שהוא מקור ההורה של חשבון Merchant Center. פורמט: accounts/{account}

name

string

חובה. השם של חשבון ה-CSS או החשבון מרובה הלקוחות המנוהל. פורמט: accounts/{account}

parent

string

אופציונלי. נדרש רק כשמאחזרים פרטים של חשבון מרובה ערוצים. דומיין ה-CSS שהוא מקור ההורה של חשבון Merchant Center. פורמט: accounts/{account}

GetCssProductRequest

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

שדות

שדות
`name`	`string` חובה. השם של מוצר ה-CSS שרוצים לאחזר. פורמט: `accounts/{account}/cssProducts/{css_product}`

name

string

חובה. השם של מוצר ה-CSS שרוצים לאחזר. פורמט: accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

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

שדות

שדות
`months`	`int64` מספר התשלומים שהקונה צריך לשלם.
`amount`	`Price` הסכום שהקונה צריך לשלם כל חודש.
`downpayment`	`Price` סכום המקדמה שהקונה צריך לשלם מראש.

months

int64

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

amount

Price

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

downpayment

Price

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

HeadlineOfferSubscriptionCost

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

שדות

שדות
`period`	`SubscriptionPeriod` סוג תקופת המינוי. הערכים הנתמכים הם: * `month` * `year`
`period_length`	`int64` מספר תקופות המינוי שהקונה צריך לשלם עליהן.
`amount`	`Price` הסכום שהקונה צריך לשלם בכל תקופת מינוי.

period

SubscriptionPeriod

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

period_length

int64

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

amount

Price

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

InsertCssProductInputRequest

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

שדות

שדות
`parent`	`string` חובה. החשבון שבו יתווסף המוצר הזה של שירות ה-CSS. פורמט: accounts/{account}
`css_product_input`	`CssProductInput` חובה. קלט המוצר של ה-CSS שרוצים להוסיף.
`feed_id (deprecated)`	`int64` הפריט הזה יצא משימוש. אופציונלי. יצא משימוש. לא נדרש מזהה פיד למוצרים בשירות CSS. המזהה של הפיד הראשי או של הפיד המשלים. אם מוצר CSS כבר קיים ומזהה הפיד שצוין שונה, מוצר ה-CSS יועבר לפיד חדש. הערה: בשלב הזה, שירותי CSS לא צריכים לספק מזהי פידים כי אנחנו יוצרים פידים תוך כדי תנועה. עדיין אין לנו תמיכה בפידים משניים למוצרים של שירותי השוואת מחירים.

parent

string

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

css_product_input

CssProductInput

חובה. קלט המוצר של ה-CSS שרוצים להוסיף.

feed_id
(deprecated)

int64

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

ListAccountLabelsRequest

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

שדות

שדות
`parent`	`string` חובה. חשבון ההורה. פורמט: accounts/{account}
`page_size`	`int32` המספר המקסימלי של התוויות שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר עד 50 תוויות. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
`page_token`	`string` טוקן של דף שהתקבל מקריאה קודמת של `ListAccountLabels`. צריך להזין את הטוקן כדי לאחזר את הדף הבא. כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-`ListAccountLabels` חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

parent

string

חובה. חשבון ההורה. פורמט: accounts/{account}

page_size

int32

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

page_token

string

טוקן של דף שהתקבל מקריאה קודמת של ListAccountLabels. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

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

ListAccountLabelsResponse

הודעת תגובה לשיטה ListAccountLabels.

שדות

שדות
`account_labels[]`	`AccountLabel` התוויות מהחשבון שצוין.
`next_page_token`	`string` טוקן שאפשר לשלוח כ-`page_token` כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

account_labels[]

AccountLabel

התוויות מהחשבון שצוין.

next_page_token

string

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

ListChildAccountsRequest

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

שדות
`parent`	`string` חובה. חשבון ההורה. הערך חייב להיות קבוצת CSS או דומיין. פורמט: accounts/{account}
`page_size`	`int32` אופציונלי. המספר המקסימלי של חשבונות שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו לכל היותר 50 חשבונות. הערך המקסימלי הוא 100. ערכים גבוהים יותר יומרו ל-100.
`page_token`	`string` אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של `ListChildAccounts`. צריך להזין את הטוקן כדי לאחזר את הדף הבא. כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-`ListChildAccounts` חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
`label_id`	`int64` אם מציינים את המזהה, יוחזרו רק חשבונות מרובי-לקוחות עם התווית שצוינה.
`full_name`	`string` אם הערך מוגדר, יוחזרו רק חשבונות המרכז לשליטה עם השם שצוין (תלוי אותיות רישיות).

ListChildAccountsResponse

הודעת תגובה לשיטה ListChildAccounts.

שדות

שדות
`accounts[]`	`Account` חשבונות ה-CSS או ה-MC שמוחזרים עבור חשבון ה-CSS הראשי שצוין.
`next_page_token`	`string` טוקן שאפשר לשלוח כ-`page_token` כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

accounts[]

Account

חשבונות ה-CSS או ה-MC שמוחזרים עבור חשבון ה-CSS הראשי שצוין.

next_page_token

string

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

ListCssProductsRequest

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

שדות

שדות
`parent`	`string` חובה. החשבון או הדומיין שבהם יופיעו מוצרים שעברו עיבוד ב-CSS. פורמט: accounts/{account}
`page_size`	`int32` מספר המוצרים המקסימלי של שירותי CSS שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000. אם לא מציינים ערך, המערכת תחזיר את המספר המקסימלי של מוצרים בשירות CSS.
`page_token`	`string` טוקן של דף שהתקבל מקריאה קודמת של `ListCssProducts`. צריך להזין את הטוקן כדי לאחזר את הדף הבא. כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-`ListCssProducts` חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

parent

string

חובה. החשבון או הדומיין שבהם יופיעו מוצרים שעברו עיבוד ב-CSS. פורמט: accounts/{account}

page_size

int32

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

page_token

string

טוקן של דף שהתקבל מקריאה קודמת של ListCssProducts. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

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

ListCssProductsResponse

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

שדות

שדות
`css_products[]`	`CssProduct` מוצרי ה-CSS שעברו עיבוד מהחשבון שצוין. אלה המוצרים שלכם בשירות ה-CSS אחרי החלת כללים ופידים משלימים.
`next_page_token`	`string` טוקן שאפשר לשלוח כ-`page_token` כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

css_products[]

CssProduct

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

next_page_token

string

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

ListQuotaGroupsRequest

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

שדות

שדות
`parent`	`string` חובה. חשבון ה-CSS שבבעלותו אוסף של מכסות משאבים ושיטות. ברוב המקרים, זהו דומיין ה-CSS. פורמט: accounts/{account}
`page_size`	`int32` אופציונלי. מספר המכסות המקסימלי שיוחזר בתשובה, לשימוש בהחלפת דפים. ערך ברירת המחדל הוא 500. ערכים מעל 1,000 יומרו ל-1,000.
`page_token`	`string` אופציונלי. טוקן (אם סופק) לאחזור הדף הבא. כל שאר הפרמטרים חייבים להיות זהים לקריאה המקורית שסיפקה את הטוקן של הדף.

parent

string

חובה. חשבון ה-CSS שבבעלותו אוסף של מכסות משאבים ושיטות. ברוב המקרים, זהו דומיין ה-CSS. פורמט: accounts/{account}

page_size

int32

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

page_token

string

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

ListQuotaGroupsResponse

הודעת התגובה לשיטה ListMethodGroups.

שדות

שדות
`quota_groups[]`	`QuotaGroup` השיטות, השימוש הנוכחי במכסה והמגבלות לכל קבוצה. המכסה משותפת לכל השיטות בקבוצה. הקבוצות ממוינות בסדר יורד על סמך `quota_usage`.
`next_page_token`	`string` טוקן שאפשר לשלוח כ-`page_token` כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

quota_groups[]

QuotaGroup

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

next_page_token

string

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

MethodDetails

פרטי השיטה לכל שיטה ב-CSS API.

שדות
`method`	`string` פלט בלבד. שם ה-method, לדוגמה `cssproductsservice.listcssproducts`.
`version`	`string` פלט בלבד. גרסת ה-API שאליה שייכת ה-method.
`subapi`	`string` פלט בלבד. ה-API המשני שאליו שייכת השיטה. ב-CSS API, הערך הזה תמיד יהיה `css`.
`path`	`string` פלט בלבד. הנתיב של השיטה, למשל `v1/cssproductsservice.listcssproducts`.

ProductDetail

פרטי המוצר.

שדות

שדות
`section_name`	`string` כותרת הקטע שמשמשת לקיבוץ של פרטי מוצרים.
`attribute_name`	`string` השם של פרטי המוצר.
`attribute_value`	`string` הערך של פרטי המוצר.

section_name

string

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

attribute_name

string

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

attribute_value

string

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

ProductDimension

הממד של המוצר.

שדות

שדות
`value`	`double` חובה. ערך המאפיין שמיוצג כמספר. הערך יכול לכלול עד ארבע ספרות אחרי הנקודה העשרונית.
`unit`	`string` חובה. יחידות המידה של המאפיין. הערכים הקבילים הם: * `in` * `cm`

value

double

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

unit

string

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

ProductWeight

משקל המוצר.

שדות

שדות
`value`	`double` חובה. המשקל מיוצג כמספר. המשקל יכול לכלול עד ארבע ספרות אחרי הנקודה.
`unit`	`string` חובה. יחידת המשקל. הערכים הקבילים הם: * `g` * `kg` * `oz` * `lb`

value

double

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

unit

string

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

QuotaGroup

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

שדות
`name`	`string` מזהה. שם המשאב של קבוצת המכסות. פורמט: accounts/{account}/quotas/{group} דוגמה: `accounts/12345678/quotas/css-products-insert` הערה: אין הבטחה שהחלק {group} יפעל לפי דפוס ספציפי.
`quota_usage`	`int64` פלט בלבד. השימוש הנוכחי במכסה, כלומר מספר הקריאות שכבר בוצעו ביום נתון לשיטות בקבוצה. מגבלות המכסה היומיות מתאפסות בחצות בצהריים לפי שעון UTC.
`quota_limit`	`int64` פלט בלבד. המספר המקסימלי של שיחות שמותר לקבוצה לבצע ביום.
`quota_minute_limit`	`int64` פלט בלבד. המספר המקסימלי של שיחות שמותר לבצע לקבוצה בדקה.
`method_details[]`	`MethodDetails` פלט בלבד. רשימה של כל השיטות שהמכסה של קבוצת השיטות חלה עליהן.

SubscriptionPeriod

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

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

UpdateAccountLabelRequest

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

שדות

שדות
`account_label`	`AccountLabel` חובה. התווית המעודכנת. חובה למלא את כל השדות.

account_label

AccountLabel

חובה. התווית המעודכנת. חובה למלא את כל השדות.

UpdateAccountLabelsRequest

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

שדות

שדות
`name`	`string` חובה. שם המשאב של התווית. פורמט: accounts/{account}
`label_ids[]`	`int64` רשימת מזהי התוויות להחלפת מזהי תוויות החשבון הקיימים. אם הרשימה ריקה, כל מזהי התוויות שמוקצים כרגע יימחקו.
`parent`	`string` אופציונלי. השדה הזה נדרש רק כשמעדכנים תוויות של חשבון ניהול. דומיין ה-CSS שהוא מקור ההורה של חשבון Merchant Center. פורמט: accounts/{account}

name

string

חובה. שם המשאב של התווית. פורמט: accounts/{account}

label_ids[]

int64

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

parent

string

אופציונלי. השדה הזה נדרש רק כשמעדכנים תוויות של חשבון ניהול. דומיין ה-CSS שהוא מקור ההורה של חשבון Merchant Center. פורמט: accounts/{account}

UpdateCssProductInputRequest

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

שדות

שדות
`css_product_input`	`CssProductInput` חובה. מקור קלט המוצרים בשירות ה-CSS שרוצים לעדכן. המידע שתשלחו יחול גם על מוצר ה-CSS שעבר עיבוד.
`update_mask`	`FieldMask` רשימת מאפייני המוצרים בשירות ה-CSS שצריך לעדכן. אם משמיטים את מסכת העדכון, היא נחשבת למסכת שדות משתמעת ששווה לכל השדות שאוכלסו (יש להם ערך לא ריק). מאפיינים שצוינו במסכת העדכון בלי שצוין ערך בגוף הבקשה יימחקו ממוצר ה-CSS. אפשר לציין מסכת עדכון רק לשדות ברמה העליונה במאפיינים ובמאפיינים מותאמים אישית. כדי לציין את מסכת העדכון למאפיינים מותאמים אישית, צריך להוסיף את הקידומת `custom_attribute.`. אספקת הערך המיוחד '*' להחלפה מלאה של מוצר CSS אינה נתמכת.

css_product_input

CssProductInput

חובה. מקור קלט המוצרים בשירות ה-CSS שרוצים לעדכן. המידע שתשלחו יחול גם על מוצר ה-CSS שעבר עיבוד.

update_mask

FieldMask

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

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

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

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

כדי לציין את מסכת העדכון למאפיינים מותאמים אישית, צריך להוסיף את הקידומת custom_attribute..

אספקת הערך המיוחד '*' להחלפה מלאה של מוצר CSS אינה נתמכת.

Package google.shopping.css.v1 קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

אינדקס

AccountLabelsService

AccountsService

CssProductInputsService

CssProductsService

QuotaService

חשבון

AccountType

AccountLabel

LabelType

מאפיינים

הסמכה

CreateAccountLabelRequest

CssProduct

CssProductInput

CssProductStatus

DestinationStatus

ItemLevelIssue

DeleteAccountLabelRequest

DeleteCssProductInputRequest

GetAccountRequest

GetCssProductRequest

HeadlineOfferInstallment

HeadlineOfferSubscriptionCost

InsertCssProductInputRequest

ListAccountLabelsRequest

ListAccountLabelsResponse

ListChildAccountsRequest

ListChildAccountsResponse

ListCssProductsRequest

ListCssProductsResponse

ListQuotaGroupsRequest

ListQuotaGroupsResponse

MethodDetails

ProductDetail

ProductDimension

ProductWeight

QuotaGroup

SubscriptionPeriod

UpdateAccountLabelRequest

UpdateAccountLabelsRequest

UpdateCssProductInputRequest

Package google.shopping.css.v1