אפשר להשתמש במשאב productstatuses
כדי לראות את הסטטוס המפורט של מוצרי השופינג.
לפרטים על בעיות נפוצות אפשר לעיין במאמר בנושא בעיות במוצרים.
המוֹכרים אחראים לעמוד בדרישות המדיניות של מודעות שופינג ושל כרטיסי מוצר חינמיים. צוות Google שופינג שומר לעצמו את הזכות לאכוף את כללי המדיניות האלה ולהגיב בהתאם אם נזהה תוכן או התנהגות שמפרים את כללי המדיניות האלה.
דרישות
כדי לראות את סטטוסי המוצרים, צריך לבצע את הפעולות הבאות:
- רושמים את החשבון ליעד.
- צריך לספק קוד מדינה תקין באחת מהדרכים הבאות:
- השדה
feedLabel
. - השדה
shipping
. - ברמת הפיד.
- הגדרות המשלוח בחשבון.
- השדה
קבלת סטטוס של מוצר
אפשר להשתמש בproductstatuses.get
כדי לראות את הסטטוס של מוצר.
אפשר להשתמש בפרמטר destinations
בבקשות get
ו-list
כדי להציג בעיות ביעד ספציפי. אם לא מציינים יעד, המערכת מחזירה בעיות מכל היעדים שעומדים בדרישות.
הנה דוגמה לבקשת get
עם פרמטרים אופציונליים של שאילתה:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle
כל התשובות מ-productstatuses.get
כוללות את השדות הבאים:
kind
: הערך הוא תמידcontent#productStatus
.creationDate
: התאריך שבו המוצר נוצר.-
lastUpdateDate
: הפעם האחרונה שבה המוצר עודכן. -
googleExpirationDate
: התאריך שבו תוקף המוצר פג. -
productId
: מזהה ה-REST של המוצר. -
title
: שם המוצר. -
link
: כתובת ה-URL של המוצר. -
destinationStatuses
: הסטטוס של המוצר בכל יעד ומדינה.
השדה itemLevelIssues
יופיע בתגובה רק אם יש למוצר בעיות ברמת הפריט בזמן השליחה של הבקשה.
זוהי דוגמה לתגובת JSON:
{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "strong_id_inaccurate",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "mpn",
"destination": "Shopping",
"description": "Incorrect product identifier [mpn]",
"detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
"documentation": "https://support.google.com/merchants/answer/160161",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "image_link_internal_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"destination": "Shopping",
"description": "Processing failed [image link]",
"detail": "Wait for the product image to be crawled again (up to 3 days)",
"documentation": "https://support.google.com/merchants/answer/6240184",
"applicableCountries": [
"US, UK"
]
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"destination": "Shopping",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}
הצגת רשימה של כל סטטוסי המוצרים
אפשר להשתמש בproductstatuses.list
כדי לראות את כל המוצרים והסטטוסים שלהם.
אפשר להשתמש בפרמטרים הבאים כדי לחדד את השאילתה:
destinations
: היעד שרוצים לראות את הסטטוסים שלו.-
pageToken
: משמש לקבלת דפים עוקבים של תוצאות. לכל דף ישnextPageToken
שאפשר להשתמש בו כדי לקבל את הדף הבא ברצף. -
maxResults
: המספר המקסימלי של תוצאות בכל דף.
הנה דוגמה לבקשת list
עם פרמטרים אופציונליים של שאילתה:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9
זוהי דוגמה לתגובת JSON:
{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
"title": "Green Headphones",
"link": "https://example.com/green-headphones/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US, UK"
]
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2020-01-09T15:36:39Z",
"lastUpdateDate": "2020-01-14T19:17:02Z",
"googleExpirationDate": "2020-02-13T19:17:02Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:43",
"title": "Green shirt",
"link": "https://example.com/shirt-green/",
"destinationStatuses": [
{
"destination": "ShoppingActions",
"status": "approved",
"approvedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:40",
"title": "Black hat",
"link": "https://example.com/hat-black/",
"destinationStatuses": [
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
}
]
}
אפשר לבדוק את הקריאה productstatuses.list
בייצור בלי חשש, כי היא לא מבצעת שינויים בנתונים.
יעדים
אלה היעדים שבהם אפשר להשתמש במוצרים של שופינג:
-
shopping ads
: מוצרים של מודעות שופינג. -
ShoppingActions
: מוצרים שנרכשו דרך 'קונים ב-Google'. -
surfaces across google
: מוצרים בכרטיסי מוצר חינמיים. -
shopping
: מוצרים שמוצגים במודעות מלאי של חנויות מקומיות.
בעיות ברמת הפריט
כל בעיה ברמת הפריט כוללת את השדות הבאים:
code
: קוד השגיאה שמשמש לקביעת הבעיה.-
servability
: מציין אם המוצר מוצג כ:disapproved
: הבעיה מונעת את הצגת המוצר.unaffected
: המוצר עדיין מוצג.
-
resolution
: מציין אם המוֹכר יכול לפתור את הבעיה. -
attributeName
: שם המאפיין שהושפע. -
destination
: היעד שמושפע. -
description
: תיאור המוצר. detail
: מספק מידע נוסף על הבעיה.-
documentation
: מציין איפה אפשר למצוא את התיעוד לגבי הבעיה. -
applicableCountries
: מציין באילו מדינות הבעיה משפיעה על המוצר.