Package google.shopping.css.v1

אינדקס

AccountLabelsService

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

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

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

היקפי הרשאות

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

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

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

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

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

היקפי הרשאות

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

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

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

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

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

היקפי הרשאות

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

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

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

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

עדכון תווית.

היקפי הרשאות

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

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

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

AccountsService

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

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

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

היקפי הרשאות

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

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

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

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

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

היקפי הרשאות

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

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

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

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

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

היקפי הרשאות

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

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

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

CssProductInputsService

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

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

מחיקת הזנת מוצרים של שירות CSS מחשבון CSS Center.

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.
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.
UpdateCssProductInput

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

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

היקפי הרשאות

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

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

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

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

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

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

היקפי הרשאות

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

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

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

חשבון

מידע על חשבון CSS או חשבון MCA.

שדות
name

string

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

string

פלט בלבד. אי אפשר לשנות. השם המלא של חשבון ה-CSS או חשבון ה-MC.
label_ids[]

int64

מזהי תוויות שנוצרו באופן ידני והוקצו לחשבון ה-CSS או לחשבון ה-MCA על ידי חשבון הורה של שירות 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 לחשבונות מרובי-לקוחות. הערך הזה מוחזר רק אם למשתמש יש גישה לחשבון ההורה. הערה: בחשבונות משנה של 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 חשבון 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.
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_ads_redirect

string

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

int64

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

string

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

string

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

CreateAccountLabelRequest

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

שדות
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 ולגבי המוצר המעובד בשירות ה-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}

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.

GetAccountRequest

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

שדות
name

string

חובה. השם של חשבון ה-CSS או חשבון המרכז למוכרים המנוהל. פורמט: accounts/{account}
parent

string

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

GetCssProductRequest

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

שדות
name

string

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

HeadlineOfferInstallment

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

שדות
months

int64

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

Price

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

Price

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

HeadlineOfferSubscriptionCost

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

שדות
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 לא צריכים לספק מזהי פידים כי אנחנו יוצרים פידים תוך כדי תנועה. אנחנו עדיין לא תומכים בפידים משלימים במוצרים של שירותי CSS.

ListAccountLabelsRequest

הודעת בקשה לשיטה 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 כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

ListChildAccountsRequest

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

שדות
parent

string

חובה. החשבון הראשי. הערך חייב להיות קבוצת CSS או דומיין. פורמט: accounts/{account}
page_size

int32

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

string

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

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

int64

אם מציינים מזהה תווית, יוחזרו רק חשבונות MC עם התווית שצוינה.
full_name

string

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

ListChildAccountsResponse

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

שדות
accounts[]

Account

חשבונות ה-CSS או ה-MC שמשויכים לחשבון הראשי של שירות ה-CSS שצוין.
next_page_token

string

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

ListCssProductsRequest

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

שדות
parent

string

חובה. החשבון או הדומיין שבהם יופיעו מוצרים שעברו עיבוד של שירות השוואת מחירים. פורמט: 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 כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

ListQuotaGroupsRequest

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

שדות
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 כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

MethodDetails

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

שדות
method

string

פלט בלבד. שם ה-method, לדוגמה cssproductsservice.listcssproducts.
version

string

פלט בלבד. גרסת ה-API שאליה שייכת ה-method.
subapi

string

פלט בלבד. ה-API המשני שאליו שייכת ה-method. ב-CSS API, הערך הזה הוא תמיד css.
path

string

פלט בלבד. הנתיב של השיטה, למשל v1/cssproductsservice.listcssproducts.

ProductDetail

פרטי המוצר.

שדות
section_name

string

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

string

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

string

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

ProductDimension

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

שדות
value

double

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

string

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

ProductWeight

משקל המוצר.

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

פלט בלבד. השימוש הנוכחי במכסה, כלומר מספר הקריאות שכבר בוצעו ביום נתון לשיטות בקבוצה. מכסות יומיות מתאפסות בצהריים (12:00) לפי שעון UTC.
quota_limit

int64

פלט בלבד. המספר המקסימלי של שיחות שמותר לקבוצה לבצע ביום.
quota_minute_limit

int64

פלט בלבד. המספר המקסימלי של שיחות שמותר לבצע לקבוצה בדקה.
method_details[]

MethodDetails

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

SubscriptionPeriod

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

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

UpdateAccountLabelRequest

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

שדות
account_label

AccountLabel

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

UpdateAccountLabelsRequest

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

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