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 או חשבונות מרובי לקוחות.

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 או לחשבונות MCA על ידי דומיין 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 או חשבון מרובה לקוחות.

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

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

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

string

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

ListChildAccountsResponse

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

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

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 המשני שאליו שייכת השיטה. ב-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

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