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