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

אפשר להשתמש במקור המידע Product כדי לראות את הסטטוס המפורט של שופינג.

באמצעות Content API אפשר לאחזר את סטטוס המוצר על ידי שליחת קריאה אמצעי תשלום אחד (ProductStatuses.get). בעזרת Merchant API אפשר לאחזר את המוצר על ידי אחזור המשאב Accounts.Products.

באחריותך לפעול בהתאם למדיניות שופינג פרסומות ובחינם המדיניות בנושא כרטיסי מוצר. מודעות שופינג שומרת לעצמה את הזכות לאכוף את כללי המדיניות האלה ולהגיב בהתאם, למצוא תוכן או התנהגות שמפרים את המדיניות הזו.

דרישות

כדי לראות סטטוסים של מוצרים:

• רישום החשבון ביעד.
• צריך לספק קוד מדינה תקין באחת מהמדינות הבאות:
  • השדה feedLabel.
  • השדה shipping.
  • ברמת הפיד.
  • בהגדרות המשלוח של החשבון.

הצגת סטטוס של מוצר

מאחזרים את המשאב Accounts.Products כדי להציג את הסטטוס של מוצר.

הנה בקשת GET לדוגמה:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

כל התשובות מ-products.get כוללות את השדות הבאים:

• creationDate: התאריך שבו המוצר נוצר.
• lastUpdateDate: הפעם האחרונה שבה המוצר עודכן.
• googleExpirationDate: התאריך שבו תוקף המוצר פג.
• destinationStatuses: היעדים שאליהם מיועד המוצר.
• itemLevelIssues: רשימה של כל הבעיות שמשויכות למוצר.

השדה itemLevelIssues יופיע בתשובה רק אם יש למוצר בעיות ברמת הפריט במועד הבקשה.

דוגמה לתגובת JSON:

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

הצגת רשימה של כל הסטטוסים של המוצרים

באמצעות products.list אפשר להציג את כל המוצרים ואת הסטטוסים שלהם.

אפשר להשתמש בפרמטרים הבאים כדי לצמצם את השאילתה:

• pageToken: משמש לקבלת דפי התוצאות הבאים. בכל דף יש באמצעות nextPageToken אפשר להשתמש כדי לקבל את הדף הבא ברצף.
• maxResults: מספר התוצאות המקסימלי לדף.

הנה בקשת list לדוגמה עם פרמטרים אופציונליים של שאילתה:

GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

דוגמה לתגובת JSON:

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

הקריאה productstatuses.list בטוחה לבדיקה בסביבת הייצור, כי היא לא לבצע שינויים בנתונים.

בעיות ברמת הפריט

כל בעיה ברמת הפריט כוללת את השדות הבאים:

• code: קוד השגיאה של הבעיה.
• severity: חומרת הבעיה.
• resolution: מודיע אם המוכר יכול לפתור את הבעיה.
• attribute: שם המאפיין המושפע.
• reportingContext: ההקשר הדיווח שאליו הבעיה רלוונטית.
• description: תיאור הבעיה.
• detail: מספק מידע נוסף על הבעיה.
• documentation: כתובת ה-URL של התיעוד לגבי הבעיה.
• applicableCountries: מציין באילו מדינות הבעיה משפיעה המוצר.