प्रॉडक्ट की स्थिति देखना

अपने शॉपिंग प्रॉडक्ट की पूरी जानकारी देखने के लिए, accounts.products संसाधन का इस्तेमाल किया जा सकता है.

अगर प्रॉडक्ट जोड़ने के लिए Content API for Shopping का इस्तेमाल किया जा रहा है, तो Merchant Center के प्रॉडक्ट एपीआई का इस्तेमाल शुरू करने का तरीका जानने के लिए, माइग्रेशन गाइड देखें.

शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग की नीतियों का पालन करना आपकी ज़िम्मेदारी है. शॉपिंग विज्ञापनों के लिए बनी नीतियों को लागू करने का अधिकार, Google के पास सुरक्षित है. साथ ही, अगर हमें इन नीतियों का उल्लंघन करने वाला कॉन्टेंट या व्यवहार मिलता है, तो हम ज़रूरत के हिसाब से कार्रवाई करेंगे.

ज़रूरी शर्तें

प्रॉडक्ट के स्टेटस देखने के लिए, आपको यह तरीका अपनाना होगा:

  • अपने खाते को किसी प्रोग्राम में रजिस्टर करें.
  • इनमें से किसी एक देश का मान्य कोड दें. प्रॉडक्ट, दिए गए देशों के यूनियन को टारगेट करेगा:

प्रॉडक्ट की स्थिति देखना

किसी प्रॉडक्ट की स्थिति देखने के लिए, accounts.products रिसॉर्स को वापस पाएं.

यहां GET अनुरोध का सैंपल दिया गया है:

GET https://merchantapi.googleapis.com/products/v1beta/accounts/ACCOUNT_ID/products/PRODUCT_ID

products.get के सभी जवाबों में, ProductStatus मैसेज के साथ ये फ़ील्ड शामिल होते हैं:

  • 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"
}

अस्वीकार किए गए सभी प्रॉडक्ट वापस पाना

अस्वीकार किए गए या ज़रूरी शर्तें पूरी न करने वाले सभी प्रॉडक्ट वापस पाने के लिए, यहां दिए गए accounts.reports.search अनुरोध का इस्तेमाल करें:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'"
}

Merchant Reports API का इस्तेमाल करके, प्रॉडक्ट को फ़िल्टर करने और उन्हें वापस पाने के बारे में ज़्यादा जानने के लिए, अपने प्रॉडक्ट का आकलन करना लेख पढ़ें.

ऐसे सभी प्रॉडक्ट वापस पाना जिनकी समीक्षा बाकी है

जिन प्रॉडक्ट की समीक्षा बाकी है उन्हें वापस पाने के लिए, इस अनुरोध का इस्तेमाल करें:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/{ACCOUNT_ID}/reports:search

{
  "query": "SELECT id,offer_id,feed_label,title FROM product_view WHERE aggregated_reporting_context_status = 'PENDING'"
}

प्रॉडक्ट के सभी स्टेटस की सूची

अपने सभी प्रॉडक्ट और उनके स्टेटस देखने के लिए, 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"
  }
]
}

products.list कॉल को प्रॉडक्शन में टेस्ट करना सुरक्षित है, क्योंकि इससे आपके डेटा में कोई बदलाव नहीं होता.

सामान के लेवल पर समस्याएं

आइटम-लेवल की हर समस्या में ये फ़ील्ड शामिल होते हैं:

  • code: समस्या का गड़बड़ी कोड.
  • severity: समस्या की गंभीरता.
  • resolution: इससे पता चलता है कि व्यापारी/कंपनी समस्या को हल कर सकती है या नहीं.
  • attribute: उस एट्रिब्यूट का नाम जिस पर असर पड़ा है.
  • reportingContext: रिपोर्टिंग कॉन्टेक्स्ट, जिस पर समस्या लागू होती है.
  • description: समस्या की जानकारी.
  • detail: समस्या के बारे में ज़्यादा जानकारी देता है.
  • documentation: समस्या के बारे में दस्तावेज़ का यूआरएल.
  • applicableCountries: इससे पता चलता है कि किन देशों में समस्या, प्रॉडक्ट पर असर डालती है.