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

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