במקור המידע productstatuses
אפשר לראות את הסטטוס המפורט של המוצרים ב-Google שופינג.
פרטים על בעיות נפוצות מפורטות בקטע בעיות במוצרים.
המוכרים אחראים לציית למדיניות בנושא מודעות שופינג וכרטיסי מוצר חינמיים. ל-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
: מציין באילו מדינות הבעיה משפיעה על המוצר.