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

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