وضعیت های محصول

می توانید از منبع 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 : نشان می دهد که این مشکل در کدام کشورها بر محصول تأثیر می گذارد.