סטטוסים של מוצרים

אפשר להשתמש במקור המידע productstatuses כדי לראות את הסטטוס המפורט של המוצרים שלכם ב-Google שופינג.

לעיון בבעיות במוצרים אפשר לקרוא פרטים על בעיות נפוצות.

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