REST Resource: accounts.cssProducts

Kaynak: CssProduct

İşlenen CSS ürünü.

JSON gösterimi
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Alanlar
name

string

CSS ürünün adı. Biçim: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

Yalnızca çıkış. Ürününüz için benzersiz ham tanımlayıcınız.

contentLanguage

string

Yalnızca çıkış. Ürünün iki harfli ISO 639-1 dil kodu.

feedLabel

string

Yalnızca çıkış. Ürünün feed etiketi.

attributes

object (Attributes)

Yalnızca çıkış. Ürün özelliklerinin listesi.

customAttributes[]

object (CustomAttribute)

Yalnızca çıkış. Özel (CSS tarafından sağlanan) özelliklerin listesi. Ayrıca, feed spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, API tarafından açıkça gösterilmeyen özellikleri (ör. Google ile Satın Al için kullanılan ek özellikler) göndermek için kullanışlıdır.

cssProductStatus

object (CssProductStatus)

Yalnızca çıkış. Ürünün durumu, veri doğrulama sorunları, yani bir ürünle ilgili olarak eşzamansız olarak hesaplanan bilgiler.

Özellikler

CSS ürünü için özellikler.

JSON gösterimi
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string
}
Alanlar
lowPrice

object (Price)

CSS Ürününün Düşük Fiyatı.

highPrice

object (Price)

CSS Ürününün Yüksek Fiyatı.

headlineOfferPrice

object (Price)

CSS Ürününün Başlıktaki Fiyatı.

headlineOfferShippingPrice

object (Price)

CSS Ürününün Başlıktaki Fiyatı.

productTypes[]

string

Öğenin kategorileri (ürün verileri spesifikasyonunda olduğu gibi biçimlendirilir).

sizeTypes[]

string

Öğenin kesimi. Giyim ürünleri için birleştirilmiş beden türlerini temsil etmek üzere kullanılabilir. En fazla iki beden türü sağlanabilir (bkz. [https://support.google.com/merchants/answer/6324497](beden türü)).

productDetails[]

object (ProductDetail)

Teknik özellikler veya ek ürün bilgileri.

productWeight

object (ProductWeight)

Ürünün, belirtilen birimlerdeki ağırlığı. Değer 0 (hariç) ile 2000 (dahil) arasında olmalıdır.

productLength

object (ProductDimension)

Ürünün, sağlanan birim cinsinden uzunluğu. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.

productWidth

object (ProductDimension)

Ürünün, sağlanan birim cinsinden genişliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.

productHeight

object (ProductDimension)

Ürünün, sağlanan birim cinsinden yüksekliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.

productHighlights[]

string

Bir ürünün en alakalı özelliklerini açıklayan madde noktaları.

certifications[]

object (Certification)

CSS'nin belirli bir ürün için hak talebinde bulunduğu sertifikaların listesi.

expirationDate

string (Timestamp format)

Öğenin geçerlilik süresinin sona ereceği tarih (ekleme sırasında belirtildiği şekilde) ISO 8601 biçiminde. Gerçek son kullanma tarihi, productstatuses içinde googleExpirationDate olarak gösterilir ve expirationDate çok ilerideyse daha erken olabilir. Not: Öğenin geçerlilik süresinin sona ermesinden sonra silinmesi 2 günden uzun sürebilir.

includedDestinations[]

string

Bu hedef için dahil edilecek hedeflerin listesi (Merchant Center'daki işaretli onay kutularına karşılık gelir). Varsayılan hedefler, excludedDestinations içinde belirtilmediği sürece her zaman dahil edilir.

excludedDestinations[]

string

Bu hedef için hariç tutulacak hedeflerin listesi (Merchant Center'daki işaretli olmayan onay kutularına karşılık gelir).

headlineOfferInstallment

object (HeadlineOfferInstallment)

Bir öğe için ödenecek taksit sayısı ve tutarı.

headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

İlişkili bir abonelik sözleşmesi olan bir öğe için dönem sayısı (ay veya yıl) ve dönem başına ödeme tutarı.

cppAdsRedirect

string

Ürün reklamları bağlamında ürün gösterildiğinde reklamverenlerin öğe URL'sini geçersiz kılmasına olanak tanır.

numberOfOffers

string (int64 format)

CSS ürününün sayısı.

headlineOfferCondition

string

Başlıktaki teklifin durumu.

title

string

Öğenin başlığı.

description

string

Öğenin açıklaması.

brand

string

Ürünle İlgili Özellikler.[14-36] Öğenin markası.

mpn

string

Öğenin Üretici Parça Numarası (MPN).

gtin

string

Öğenin Global Ticari Öğe Numarası (GTIN).

googleProductCategory

string

Google'ın öğe kategorisi (Google ürün sınıflandırmasına bakın). Ürünler sorgulanırken bu alan, kullanıcı tarafından sağlanan değeri içerir. Otomatik olarak atanan Google ürün kategorilerini API üzerinden geri almak şu anda mümkün değildir.

adult

boolean

Öğe yetişkinlere yönelikse doğru değerine ayarlayın.

multipack

string (int64 format)

Satıcı tarafından tanımlanan çoklu ambalajdaki benzer ürünlerin sayısıdır.

isBundle

boolean

Öğenin satıcı tarafından tanımlanan bir paket olup olmadığı. Paket, satıcı tarafından tek fiyat üzerinden satılan farklı ürünlerin özel bir gruplandırılmasıdır.

ageGroup

string

Öğeyle hedeflenen yaş grubu.

color

string

Öğenin rengi.

gender

string

Öğenin hedef cinsiyeti.

material

string

Öğenin yapıldığı malzeme.

pattern

string

Öğenin deseni (ör. benekli).

size

string

Öğenin bedeni. Yalnızca bir değere izin verilir. Farklı bedenleri olan varyantlar için her beden için aynı itemGroupId değerine sahip ayrı bir ürün ekleyin (bkz. [https://support.google.com/merchants/answer/6324492](beden tanımı)).

sizeSystem

string

Bedenin belirtildiği sistem. Giyim öğeleri için önerilir.

itemGroupId

string

Aynı ürünün tüm varyantlarının ortak tanımlayıcısı.

pause

string

Bu öğenin yayını geçici olarak duraklatılır.

customLabel0

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 0.

customLabel1

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 1.

customLabel2

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 2.

customLabel3

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 3.

customLabel4

string

Alışveriş kampanyasındaki öğeleri özel olarak gruplandırmak için özel etiket 4.

Fiyat

Sayı ve para birimi olarak gösterilen fiyat.

JSON gösterimi
{
  "amountMicros": string,
  "currencyCode": string
}
Alanlar
amountMicros

string (int64 format)

Mikro cinsinden bir sayı olarak temsil edilen fiyat (1 milyon mikro, para biriminin standart birimine eşdeğerdir. Örneğin, 1 ABD doları = 1.000.000 mikro).

currencyCode

string

ISO 4217'ye göre üç harfli kısaltmalar kullanılarak gösterilen fiyatın para birimi.

ProductDetail

Ürün ayrıntıları.

JSON gösterimi
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Alanlar
sectionName

string

Bir dizi ürün ayrıntısını gruplandırmak için kullanılan bölüm başlığı.

attributeName

string

Ürün ayrıntısının adı.

attributeValue

string

Ürün ayrıntısının değeri.

ProductWeight

Ürünün ağırlığı.

JSON gösterimi
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Zorunlu. Sayı olarak gösterilen ağırlık. Ağırlık, en fazla dört ondalık basamak hassasiyetine sahip olabilir.

unit

string

Zorunlu. Ağırlık birimi. Kabul edilen değerler: * "g" * "kg" * "oz" * "lb"

ProductDimension

Ürünün boyutu.

JSON gösterimi
{
  "value": number,
  "unit": string
}
Alanlar
value

number

Zorunlu. Sayı olarak temsil edilen boyut değeri. Değer en fazla dört ondalık basamaklı olabilir.

unit

string

Zorunlu. Boyut birimleri. Kabul edilen değerler: * "in" * "cm"

Sertifika

Ürünün sertifikası. Bir ürünle ilişkili sertifikaları (enerji verimlilik dereceleri gibi) tanımlamak için bu özelliği kullanın.

JSON gösterimi
{
  "name": string,
  "authority": string,
  "code": string
}
Alanlar
name

string

Sertifikanın adı. Şu anda en yaygın değer, AB Avrupa Enerji Etiketleme Tescili (EPREL) veritabanındaki enerji verimliliği sertifikalarını temsil eden "EPREL"dir.

authority

string

Sertifikanın verilmesinden sorumlu yetkili kuruluş veya sertifika kuruluşu. Şu anda en yaygın değer, AB'deki enerji etiketleri için "EC" veya "European_Commission"dir.

code

string

Sertifikanın kodu. Örneğin, https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 bağlantısına sahip EPREL sertifikası için 123456 kodu kullanılır. Kod, Avrupa Enerji Etiketleri için zorunludur.

HeadlineOfferInstallment

Taksitleri temsil eden bir mesaj.

JSON gösterimi
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Alanlar
months

string (int64 format)

Alıcının ödemesi gereken taksit sayısı.

amount

object (Price)

Alıcının her ay ödemesi gereken tutar.

downpayment

object (Price)

Alıcının ödemesi gereken peşinat tutarı.

HeadlineOfferSubscriptionCost

Ürünün SubscriptionCost değeri.

JSON gösterimi
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Alanlar
period

enum (SubscriptionPeriod)

Abonelik döneminin türü. Desteklenen değerler: * "month" * "year"

periodLength

string (int64 format)

Alıcının ödemesi gereken abonelik dönemi sayısı.

amount

object (Price)

Alıcının abonelik dönemi başına ödemesi gereken tutar.

SubscriptionPeriod

Ürünün abonelik dönemi.

Sıralamalar
SUBSCRIPTION_PERIOD_UNSPECIFIED Abonelik döneminin belirtilmediğini gösterir.
MONTH Abonelik döneminin ay olduğunu belirtir.
YEAR Abonelik süresinin yıl olduğunu gösterir.

CustomAttribute

Özel özellikleri temsil eden bir mesaj. value veya groupValues özelliklerinden biri boş olmamalıdır.

JSON gösterimi
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Alanlar
groupValues[]

object (CustomAttribute)

Bu özellik grubundaki alt özellikler. groupValues boş değilse value boş olmalıdır.

name

string

Özelliğin adı.

value

string

Özelliğin değeri. value boş değilse groupValues boş olmalıdır.

CssProductStatus

CSS ürünün durumu, veri doğrulama sorunları, yani CSS ürünü hakkındaki bilgiler eşzamansız olarak hesaplanır.

JSON gösterimi
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Alanlar
destinationStatuses[]

object (DestinationStatus)

Ürünün hedeflenen hedefleri.

itemLevelIssues[]

object (ItemLevelIssue)

Ürünle ilişkili tüm sorunların listesi.

creationDate

string (Timestamp format)

Öğenin oluşturulduğu tarih (ISO 8601 biçiminde).

lastUpdateDate

string (Timestamp format)

Öğenin son güncellendiği tarih (ISO 8601 biçiminde).

googleExpirationDate

string (Timestamp format)

Öğenin süresinin dolan tarihi (ISO 8601 biçiminde).

DestinationStatus

Ürün durumunun hedef durumu.

JSON gösterimi
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Alanlar
destination

string

Hedefin adı

approvedCountries[]

string

CSS ürününün onaylandığı ülke kodlarının (ISO 3166-1 alpha-2) listesi.

pendingCountries[]

string

CSS ürünü için onay bekleyen ülke kodlarının (ISO 3166-1 alpha-2) listesi.

disapprovedCountries[]

string

CSS ürünü için onaylanmayan ülke kodlarının (ISO 3166-1 alpha-2) listesi.

ItemLevelIssue

Ürün durumunun ItemLevelIssue özelliği.

JSON gösterimi
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Alanlar
code

string

Sorunun hata kodu.

servability

string

Bu sorunun CSS ürünün yayınlanmasını nasıl etkilediği.

resolution

string

Sorunun satıcı tarafından çözülüp çözülemeyeceği.

attribute

string

Sorun tek bir özellikten kaynaklanıyorsa özelliğin adı.

destination

string

Sorunun geçerli olduğu hedef.

description

string

İngilizce olarak kısa bir sorun açıklaması.

detail

string

İngilizce olarak ayrıntılı bir sorun açıklaması.

documentation

string

Bu sorunun çözülmesine yardımcı olacak bir web sayfasının URL'si.

applicableCountries[]

string

CSS ürünü için sorunun geçerli olduğu ülke kodlarının (ISO 3166-1 alpha-2) listesi.

Yöntemler

get

İşlenen CSS ürünü CSS Center hesabınızdan alınır.

list

CSS Center hesabınızda işlenen CSS ürünlerini listeler.