Ürün durumları

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

Yaygın sorunların ayrıntıları için ürünle ilgili sorunlar bölümünü inceleyin.

Alışveriş reklamları ve ücretsiz listelemeler politikalarına uymak, satıcıların sorumluluğundadır. Google Alışveriş, bu politikaları ihlal eden içerik veya davranış tespit etmemiz halinde 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 gönderim ayarları.

Bir ürünün durumunu öğrenme

Bir ürünün durumunu görüntülemek için productstatuses.get aracını 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 görebilirsiniz:

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

productstatuses.get tarafından verilen 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üncellenme zamanı.
  • googleExpirationDate: Ürünün 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.

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ı listeleme

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

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

  • destinations: Durumlarının görüntüleneceği hedef.
  • pageToken: Sonraki sonuç sayfalarını almak için kullanılır. Her sayfada, dizideki bir sonraki sayfaya ulaşmak 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 görebilirsiniz:

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

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

Her öğe düzeyindeki 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ı.
  • detail: Sorunla ilgili daha fazla bilgi verir.
  • documentation: Sorunla ilgili belgelerin nerede bulunacağını belirtir.
  • applicableCountries: Sorunun hangi ülkelerde ürünü etkilediğini belirtir.