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/MC יחיד לפי מזהה.

היקפי הרשאה

נדרשת הרשאת 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/MC על ידי דומיין CSS.

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.

CssProductInputsService

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

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

שירות לאחזור ולרישום של מוצרים ב-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/MC.

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

homepage_uri

string

פלט בלבד. לא ניתן לשינוי. דף הבית של חשבון ה-CSS/MC.

parent

string

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

סוג החיתוך של הפריט. אפשר להשתמש בו כדי לייצג סוגי מידות משולבים של פריטי לבוש. אפשר לציין עד שני סוגים של מידות (מידע נוסף זמין במאמר [https://support.google.com/merchants/answer/6324497](סוג מידה)).

product_details[]

ProductDetail

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

product_weight

ProductWeight

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

product_length

ProductDimension

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

product_width

ProductDimension

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

product_height

ProductDimension

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

product_highlights[]

string

נקודות שמתארות את הפרטים החשובים והרלוונטיים ביותר של מוצר.

certifications[]

Certification

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

expiration_date

Timestamp

התאריך שבו התוקף של הפריט יפוג, כפי שצוין בזמן ההוספה, בפורמט ISO 8601. תאריך התפוגה בפועל מוצג ב-productstatuses בתור googleExpirationDate, ויכול להיות שהוא יהיה מוקדם יותר אם expirationDate רחוק מדי בעתיד. הערה: יכול להיות שיחלפו יותר מ-2 ימים מתאריך התפוגה עד שהפריט יימחק בפועל.

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

הסמכה

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

שדות
name

string

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

authority

string

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

code

string

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

CreateAccountLabelRequest

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

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

מזהה. השם של הקלט של מוצר CSS. הפורמט: 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

חובה. קוד השפה בן שתי האותיות לפי תקן ISO 639-1 של המוצר ב-CSS.

feed_label

string

חובה. תווית הפיד של מוצר ה-CSS. התווית של הפיד היא שם נרדף ל'מדינה היעד', ולכן היא תמיד צריכה להיות קוד אזור חוקי. לדוגמה: 'DE' לגרמניה, 'FR' לצרפת.

freshness_time
(deprecated)

Timestamp

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

אסור להגדיר בשדה הזה שעה עתידית.

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

אם לא תגדירו את השדה, העדכון לא יונעל וזמני העדכון האחרונים יהיו ברירת המחדל של הזמן שבו הבקשה התקבלה על ידי CSS API.

אם הפעולה תימנע, תופעל החריגה aborted.

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

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

שדות
name

string

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

parent

string

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

GetCssProductRequest

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

שדות
name

string

חובה. השם של מוצר ה-CSS שרוצים לאחזר.

HeadlineOfferInstallment

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

שדות
months

int64

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

amount

Price

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

downpayment

Price

סכום המקדמה שעל הקונה לשלם מראש.

HeadlineOfferSubscriptionCost

הערך של SubscriptionCost של המוצר.

שדות
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 יומרו לערך 1,000.

page_token

string

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

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

ListAccountLabelsResponse

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

שדות
account_labels[]

AccountLabel

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

next_page_token

string

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

ListChildAccountsRequest

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

שדות
parent

string

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

page_size

int32

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

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

page_size

int32

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

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

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

שדות
name

string

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

label_ids[]

int64

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

parent

string

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

UpdateCssProductInputRequest

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

שדות
css_product_input

CssProductInput

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

update_mask

FieldMask

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

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

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

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

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

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