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

אנחנו רוצים להציג את גרסת הבטא של Merchant API. זוהי הגרסה החדשה של Content API for Shopping, של העתיד.

כדי ללמוד איך Merchant API יכול לשפר את השילוב ואיך אתם יכולים לעזור לעצב את העתיד אפשר לקרוא את המאמר הודעה על גרסת הבטא של Merchant API.

שירותי השוואת מחירים (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 ונקודות הקצה (endpoints) של שירותי 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.

כששולחים קריאה לנקודות קצה (endpoints) של 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. הדוגמה הבאה ממחישה איך להחיל את התווית חשבונות מפתח שנוצרה בדוגמה הקודמת על אחד מחשבונות 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. הדוגמה הבאה ממחישה איך להחיל תווית ברמת הקבוצה של דומיינים מרכזיים שנוצרה באמצעות השיטה 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’
}