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

می توانید از منبع productstatuses برای مشاهده وضعیت دقیق محصولات خرید خود استفاده کنید.

برای جزئیات مشکلات رایج، مشکلات محصول را ببینید.

تاجران مسئول پیروی از خط‌مشی‌های تبلیغات خرید و فهرست‌های رایگان هستند. Google Shopping این حق را برای خود محفوظ می‌دارد که این خط‌مشی‌ها را اجرا کند و در صورت مشاهده محتوا یا رفتاری که این خط‌مشی‌ها را نقض می‌کند، به آن پاسخ مناسب بدهد.

الزامات

برای مشاهده وضعیت محصول باید موارد زیر را انجام دهید:

• حساب خود را در یک مقصد ثبت کنید.
• یک کد کشور معتبر در یکی از موارد زیر ارائه کنید:
  • فیلد feedLabel .
  • حوزه shipping .
  • در سطح خوراک.
  • تنظیمات حمل و نقل حساب شما

وضعیت یک محصول را دریافت کنید

برای مشاهده وضعیت یک محصول productstatuses.get استفاده کنید.

می‌توانید از پارامتر destinations در درخواست‌های get و list برای مشاهده مسائل مربوط به یک مقصد خاص استفاده کنید. اگر مقصدی را مشخص نکنید، موارد از همه مقاصد واجد شرایط برگردانده می‌شوند.

در اینجا یک نمونه درخواست get ، با پارامترهای پرس و جو اختیاری است:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

همه پاسخ‌ها از productstatuses.get شامل فیلدهای زیر است:

• kind : ارزش همیشه content#productStatus است.
• creationDate : تاریخی که محصول ایجاد شده است.
• lastUpdateDate : آخرین باری که محصول به روز شد.
• googleExpirationDate : تاریخ انقضای محصول.
• productId : شناسه REST محصول.
• title : عنوان محصول.
• link : لینک URL محصول.
• destinationStatuses : وضعیت محصول در هر مقصد و کشور.

فقط در صورتی فیلد itemLevelIssues را در پاسخ خواهید دید که محصول در زمان درخواست شما مشکلاتی در سطح مورد داشته باشد.

در اینجا یک نمونه پاسخ JSON آمده است:

توجه: برخی از نام‌های مقصد محصول (عملیات خرید، سطوح در سراسر Google، سطوح محلی در سراسر Google) به‌روزرسانی شده‌اند (اکنون فهرست‌های خرید در Google، فهرست‌های رایگان، فهرست‌های محلی رایگان). متد productstatuses.get فقط مقادیر قدیمی را برمی گرداند.

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable desktop landing page",
  "detail": "Update your website or landing page URL to enable access from desktop devices",
  "documentation": "https://support.google.com/merchants/answer/6098155",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable mobile landing page",
  "detail": "Update your website or landing page URL to enable access from mobile devices",
  "documentation": "https://support.google.com/merchants/answer/6098296",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

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

از productstatuses.list برای مشاهده همه محصولات و وضعیت آنها استفاده کنید.

می توانید از پارامترهای زیر برای اصلاح درخواست خود استفاده کنید:

• destinations : مقصدی که باید وضعیت ها را مشاهده کنید.
• pageToken : برای دریافت صفحات بعدی نتایج استفاده می شود. هر صفحه دارای nextPageToken است که می توانید از آن برای دریافت صفحه بعدی در ترتیب استفاده کنید.
• maxResults : حداکثر تعداد نتایج در هر صفحه.

در اینجا یک list نمونه درخواست با پارامترهای پرس و جو اختیاری آمده است:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

در اینجا یک نمونه پاسخ JSON آمده است:

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

تماس productstatuses.list برای آزمایش در مرحله تولید بی خطر است زیرا هیچ تغییری در داده های شما ایجاد نمی کند.

مقاصد

در اینجا مقاصدی هستند که می توانید برای خرید محصولات استفاده کنید:

• shopping ads : محصولات تبلیغاتی خرید.
• ShoppingActions : محصولات Google را بخرید.
• surfaces across google : محصولات لیست رایگان.
• shopping : محصولات تبلیغات موجودی محلی.

مسائل در سطح مورد

هر مسئله در سطح آیتم شامل فیلدهای زیر است:

• code : کد خطایی که برای تعیین مشکل استفاده می شود.
• servability : نشان می دهد که آیا محصول به صورت زیر نمایش داده می شود:
  • disapproved : مشکل از نمایش محصول جلوگیری می کند.
  • unaffected : محصول هنوز نشان داده می شود.
• resolution : به اطلاع می‌رساند که آیا تاجر بتواند مشکل را حل کند.
• attributeName : نام مشخصه ای که تحت تأثیر قرار گرفته است.
• destination : مقصدی که تحت تأثیر قرار گرفته است.
• description : توضیحات محصول.
• detail : اطلاعات بیشتری در مورد مشکل ارائه می دهد.
• documentation : نشان می دهد که کجا می توان اسناد مربوط به مشکل را پیدا کرد.
• applicableCountries : نشان می دهد که این مشکل در کدام کشورها بر محصول تأثیر می گذارد.