ניהול תוויות CSS

שירותי השוואת מחירים (CSS) יכולים להציג ב-Google מודעות שופינג בשם מוכרים במדינות שבהן תוכנית שירותי ה-CSS זמינה. ה-Content API מאפשר לדומיינים של CSS ולקבוצות CSS לארגן את החשבונות המשויכים שלהם באמצעות תוויות. בדומיינים של CSS אפשר להציג, להוסיף תוויות ולסנן את חשבונות Merchant Center המשויכים לדומיין. קבוצות CSS יכולות להוסיף תוויות לדומיינים של ה-CSS שמשויכים לקבוצה, ולפרט אותם. השירותים האלה של Content API מספקים פרוגרמטיות שוות ערך לחלק מהתכונות שזמינות ב-Comparison Shopping Service Center.

מידע נוסף על שירותי CSS זמין במאמר שירותי השוואת מחירים. מידע נוסף על עבודה עם תוויות ב-CSS Center זמין במאמר שימוש בתוויות חשבון ב-Comparison Shopping Service Center.

סוגי חשבונות של שירות CSS

שירותי CSS משתמשים בשלושת סוגי החשבונות הבאים:

• קבוצות CSS הן החשבונות ברמה העליונה שיכולים להכיל דומיין CSS אחד או יותר.
• דומיינים של CSS הם החשבונות של שירותי ה-CSS עצמם, שבהם מודעות שופינג מוצגות בשם המוכרים. כל דומיין CSS יכול להשתייך רק לקבוצת CSS אחת.
• חשבונות Merchant Center הם המוכרים שעבורם דומיינים של CSS מציגים מודעות שופינג. אפשר לשייך שירותי CSS לכמה סוגים של חשבונות Merchant Center, כולל חשבונות מרובי לקוחות (חשבונות MCA) וחשבונות של מוכרים נפרדים. אפשר לשייך כל חשבון Merchant Center רק לדומיין CSS אחד. מידע נוסף על הסוגים השונים של חשבונות Merchant Center זמין במאמר סוגי חשבונות ב-Comparison Shopping Service Center.

סוגים של תוויות CSS

שירותי CSS משתמשים בשני סוגים של תוויות:

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

מידע נוסף על סוגי תוויות, כולל התוויות האוטומטיות הזמינות, זמין במאמר שימוש בתוויות חשבון ב-Comparison Shopping Service Center.

הפונקציונליות ונקודות הקצה של Content API לשירותי CSS

ב-Content API אפשר למצוא את נקודות הקצה הבאות לשירותי CSS:

• accounts.labels: מאפשרת ליצור, לאחזר ולשנות תוויות שיחולו על דומיין CSS ועל חשבונות Merchant Center. לדוגמה, ראו יצירת תווית.
• accounts.updatelabels: מאפשרת להחיל תוויות על חשבון Merchant Center אחד. לדוגמה, קראו את המאמר החלת תווית על חשבון Merchant Center.
• accounts.list: אחזור של כל חשבונות Merchant Center שמשויכים לדומיין CSS, כולל התוויות שהוחלו על כל חשבון. אפשר גם לסנן לפי התווית id כדי לאחזר קבוצת משנה של חשבונות משויכים. לדוגמה, ראו שימוש בתוויות לסינון חשבונות Merchant Center.
• accounts.get: מאפשרת לאחזר את התוויות שהוחלו על חשבון Merchant Center יחיד.
• csses: תצוגה וניהול של השיוכים בין תוויות לדומיינים של CSS. לדוגמה, תוכלו לקרוא את המאמר החלת תווית על דומיין CSS.

כשקוראים לנקודות קצה של accounts כדומיין CSS, צריך להביא בחשבון את הדרישות הבאות:

• דומיינים של CSS צריכים לספק את cssId שלהם במקום merchantId.
• דומיינים של CSS צריכים לספק פרמטר שאילתה של view=CSS.
• בדומיינים של CSS צריך לציין את מספר חשבון Merchant Center המשויך אליהם בתור accountId.

הערה: רק חשבונות של דומיין CSS וקבוצות CSS יכולים להשתמש בתוויות. לחשבונות Merchant Center עצמם אין גישה לפונקציונליות של התוויות.

דוגמה: יצירת תווית

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

הדוגמה הבאה ממחישה איך ליצור תווית של חשבונות מפתח ברמת הדומיין, ואז להחיל אותה על חשבונות Merchant Center שמשויכים לדומיין. כדי ליצור את התווית, צריך לשלוח בקשת POST באמצעות כתובת ה-URL וגוף הבקשה הבאים:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

דוגמה: החלת תווית על חשבון Merchant Center

אפשר להשתמש בשיטה accounts.updatelabels כדי להקצות תוויות לחשבון Merchant Center שמשויך לדומיין CSS. הדוגמה הבאה ממחישה איך להחיל את התווית key-accounts שנוצרה בדוגמה הקודמת על אחד מהחשבונות החשובים ביותר שלכם ב-Merchant Center.

הערה: כשמוסיפים תווית לחשבון Merchant Center, צריך להשתמש ב-id של התווית, ולא בשם. השדה id מוקצה באופן אוטומטי לתווית ויוחזר בתגובה במהלך יצירת התווית. תוכלו גם לאחזר את התווית id על ידי חיוג ל-accounts.labels.list.

כדי להחיל את התווית, צריך לשלוח בקשת POST עם כתובת ה-URL הבאה וגוף הבקשה:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

דוגמה: שימוש בתוויות לסינון חשבונות Merchant Center

אחרי שיוצרים תוויות ומחילים אותן בחשבונות Merchant Center שמשויכים לדומיין CSS, אפשר להשתמש בשיטה accounts.list ולהעביר את הפרמטר של שאילתת התווית בבקשה, כדי להחזיר רק את החשבונות שסומנו בתווית הזאת. הדוגמה הבאה ממחישה איך לסנן את חשבונות Merchant Center שמשויכים לדומיין CSS באמצעות התווית id (123) של תווית חשבונות מפתח שנוצרה בדוגמה יצירת תווית. כדי לאחזר את החשבונות, צריך לשלוח בקשת GET באמצעות כתובת ה-URL הבאה:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

אין צורך בגוף הבקשה.

דוגמה: החלת תווית על דומיין CSS

אפשר להשתמש גם בשיטה csses.updatelabels כדי להקצות תוויות לדומיין CSS המשויך לקבוצת CSS. הדוגמה הבאה ממחישה איך להחיל תווית ברמת הקבוצה key-domains שנוצרה באמצעות השיטה accounts.labels.create על אחד מהחשבונות החשובים ביותר בדומיין ב-CSS. חשוב לזכור שתוויות לדומיינים של CSS ולחשבונות Merchant Center הן נפרדות. כדי ליצור תוויות ברמת הקבוצה צריך להשתמש במזהה קבוצת ה-CSS בתור accountId שלה.

הערה: כשמחילים תווית על דומיין CSS, צריך להשתמש ב-id של התווית, ולא בשם. השדה id מוקצה באופן אוטומטי לתווית ויוחזר בתגובה במהלך יצירת התווית. תוכלו גם לאחזר את התווית id על ידי חיוג אל accounts.labels.list.

כדי להחיל את התווית, צריך לשלוח בקשת POST עם כתובת ה-URL הבאה וגוף הבקשה:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}