Ürün durumları

Alışveriş ürünlerinizin ayrıntılı durumunu görüntülemek için productstatuses kaynağını kullanabilirsiniz.

Sık karşılaşılan sorunlarla ilgili ayrıntılar için ürün sorunları başlıklı makaleyi inceleyin.

Satıcılar, Alışveriş reklamları ve ücretsiz listelemeler politikalarına uymakla yükümlüdür. Google Alışveriş, bu politikaları uygulama ve bu politikaları ihlal eden içerik veya davranış tespit etmesi durumunda gerekli işlemleri yapma hakkını saklı tutar.

Şartlar

Ürün durumlarını görmek için aşağıdakileri yapmanız gerekir:

  • Hesabınızı bir hedefe kaydetme
  • Aşağıdakilerden birinde geçerli bir ülke kodu sağlayın:
    • feedLabel alanı.
    • shipping alanı.
    • Feed düzeyinde.
    • Hesabınızın kargo ayarları

Ürünün durumunu alma

Bir ürünün durumunu görüntülemek için productstatuses.get simgesini kullanın.

Belirli bir hedefle ilgili sorunları görüntülemek için get ve list isteklerinde destinations parametresini kullanabilirsiniz. Hedef belirtmezseniz tüm uygun hedeflerdeki sorunlar döndürülür.

İsteğe bağlı sorgu parametrelerinin yer aldığı örnek bir get isteğini aşağıda bulabilirsiniz:

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

productstatuses.get'dan gelen tüm yanıtlarda aşağıdaki alanlar bulunur:

  • kind: Değer her zaman content#productStatus olur.
  • creationDate: Ürünün oluşturulduğu tarih.
  • lastUpdateDate: Ürünün son güncellenme zamanı.
  • googleExpirationDate: Ürünün geçerlilik süresinin dolduğu tarih.
  • productId: Ürünün REST kimliği.
  • title: Ürünün başlığı.
  • link: Ürünün URL bağlantısı.
  • destinationStatuses: Ürünün her hedef ve ülkedeki durumu.

itemLevelIssues alanını yanıtta yalnızca ürün, isteğiniz sırasında öğe düzeyinde sorunlar içeriyorsa görürsünüz.

Örnek bir JSON yanıtı:

{
"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"
}

Tüm ürün durumlarını listeleme

Tüm ürünlerinizi ve durumlarını görüntülemek için productstatuses.list simgesini kullanın.

Sorgunuzu daraltmak için aşağıdaki parametreleri kullanabilirsiniz:

  • destinations: Durumların görüntüleneceği hedef.
  • pageToken: Sonraki sonuç sayfalarını almak için kullanılır. Her sayfada, dizideki bir sonraki sayfaya gitmek için kullanabileceğiniz bir nextPageToken bulunur.
  • maxResults: Sayfa başına maksimum sonuç sayısı.

İsteğe bağlı sorgu parametreleri içeren örnek bir list isteğini aşağıda bulabilirsiniz:

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

Örnek bir JSON yanıtı:

{
"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 çağrısı, verilerinizde herhangi bir değişiklik yapmadığı için üretimde test edilebilir.

Hedefler

Alışveriş ürünleri için kullanabileceğiniz hedefler şunlardır:

  • shopping ads: Alışveriş reklamı ürünleri.
  • ShoppingActions: Google ile Satın Al ürünleri.
  • surfaces across google: Ücretsiz listeleme ürünleri.
  • shopping: Yerel envanter reklamları ürünleri.

Öğe düzeyindeki sorunlar

Her öğe düzeyindeki sorunda aşağıdaki alanlar bulunur:

  • code: Sorunu belirlemek için kullanılan hata kodu.
  • servability: Ürünün şu şekilde gösterilip gösterilmediğini belirtir:
    • disapproved: Sorun, ürünün gösterilmesini engelliyor.
    • unaffected: Ürün gösterilmeye devam eder.
  • resolution: Satıcının sorunu çözüp çözemeyeceği hakkında bilgi verir.
  • attributeName: Etkilenen özellik adı.
  • destination: Etkilenen hedef.
  • description: Ürünün açıklamasıdır.
  • detail: Sorun hakkında daha fazla bilgi verir.
  • documentation: Sorunla ilgili belgelerin nerede bulunacağını gösterir.
  • applicableCountries: Sorunun ürünü hangi ülkelerde etkilediğini gösterir.