পণ্যের অবস্থা

আপনি আপনার শপিং পণ্যের বিশদ স্থিতি দেখতে 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 : কোন দেশে সমস্যাটি পণ্যটিকে প্রভাবিত করে তা নির্দেশ করে।