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

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

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

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

الزامات

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

• حساب خود را در یک مقصد ثبت کنید.
• یک کد کشور معتبر در یکی از موارد زیر ارائه دهید:
  • فیلد 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 آورده شده است:

توجه: برخی از نام‌های مقاصد محصول (اقدامات خرید، سطوح در سراسر گوگل، سطوح محلی در سراسر گوگل) به‌روزرسانی شده‌اند (اکنون به صورت خرید در فهرست‌های گوگل، فهرست‌های رایگان، فهرست‌های محلی رایگان درآمده است). متد 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 : خرید از محصولات گوگل.
• surfaces across google : لیست رایگان محصولات.
• shopping : محصولات تبلیغات موجودی محلی.

مسائل مربوط به سطح آیتم

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

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