प्रॉडक्ट की स्थितियां

अपने Shopping प्रॉडक्ट की स्थिति के बारे में ज़्यादा जानकारी पाने के लिए, 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: समस्या से जुड़े दस्तावेज़ का यूआरएल.
• applicableCountries: इससे पता चलता है कि किन देशों में समस्या से प्रॉडक्ट पर असर पड़ता है.