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

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

ב-Content API אפשר לאחזר את סטטוס המוצר על ידי קריאה ל-method 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: מציין באילו מדינות הבעיה משפיעה על המוצר.