Ü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 sorunların ayrıntıları için ürün sorunları bölümüne bakın.

Alışveriş reklamları ve ücretsiz listeleme politikalarına uymaktan satıcılar sorumludur. Google Alışveriş, bu politikaları ihlal eden içerik veya davranış tespit etmemiz durumunda bu politikaları uygulama ve uygun şekilde yanıt verme hakkını saklı tutar.

Koşullar

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

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

Bir ürünün durumunu öğrenme

Bir ürünün durumunu görmek için productstatuses.get öğesini 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.

Aşağıda, isteğe bağlı sorgu parametreleri içeren örnek bir get isteği verilmiştir:

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

productstatuses.get adlı kullanıcının tüm yanıtları aşağıdaki alanları içerir:

  • kind: Değer her zaman content#productStatus olur.
  • creationDate: Ürünün oluşturulduğu tarih.
  • lastUpdateDate: Ürünün son güncellendiği zaman.
  • googleExpirationDate: Ürünün süresinin dolacağı 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.

Yanıtta itemLevelIssues alanını yalnızca isteğiniz sırasında üründe öğe düzeyinde sorunlar varsa görürsünüz.

Aşağıda örnek bir JSON yanıtı verilmiştir:

{
"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ı listele

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

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

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

Aşağıda, isteğe bağlı sorgu parametreleri içeren örnek bir list isteği verilmiştir:

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

Aşağıda örnek bir JSON yanıtı verilmiştir:

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

Verilerinizde herhangi bir değişiklik yapmadığı için productstatuses.list çağrısını üretimde test etmek güvenlidir.

Hedefler

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

  • shopping ads: Alışveriş reklamları ü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

Öğe düzeyindeki her sorun aşağıdaki alanları içerir:

  • 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 hâlâ gösteriliyor.
  • resolution: Satıcının sorunu çözüp çözemeyeceğini bildirir.
  • attributeName: Etkilenen özellik adı.
  • destination: Etkilenen hedef.
  • description: Ürünün açıklamasıdır.
  • detail: Sorunla ilgili daha fazla bilgi verir.
  • documentation: Sorunla ilgili dokümanların nerede bulunacağını belirtir.
  • applicableCountries: Sorunun hangi ülkelerde ürünü etkilediğini belirtir.