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

आप Product संसाधन का इस्तेमाल करके, अपने शॉपिंग प्रॉडक्ट.

Content API का इस्तेमाल करके, प्रॉडक्ट की स्थिति जानने के लिए, ProductStatuses.get तरीका. Merchant API की मदद से, प्रॉडक्ट को वापस पाया जा सकता है Accounts.Products संसाधन को वापस पाने की स्थिति में.

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

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

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

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