שירותי השוואת מחירים (CSS) יכולים להציג ב-Google מודעות שופינג בשם מוכרים, במדינות שבהן התוכנית של שירותי CSS זמינה. Content API מאפשר לדומיינים של CSS ולקבוצות CSS לארגן את החשבונות המשויכים באמצעות תוויות. בדומיינים של שירותי CSS אפשר לרשום, לתייג ולסנן את חשבונות Merchant Center שמשויכים לדומיין. קבוצות CSS יכולות להוסיף תוויות לדומיינים של CSS שמשויכים לקבוצה ולרשום אותם. שירותי Content API האלה מספקים מקבילות תוכנתיות לחלק מהתכונות שזמינות ב-Comparison Shopping Service Center.
מידע נוסף על שירותי השוואת מחירים זמין במאמר בנושא שירותי השוואת מחירים. מידע על עבודה עם תוויות ב-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
.
דוגמה: יצירת תווית
אפשר להשתמש בשיטה 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 החשובים ביותר שלכם.
כדי להחיל את התווית, שולחים בקשת 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
) של התווית key-accounts שנוצרה בדוגמה יצירת תווית. כדי לאחזר את החשבונות, שולחים בקשת 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
.
כדי להחיל את התווית, שולחים בקשת POST
באמצעות כתובת ה-URL וגוף הבקשה הבאים:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}