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ün adı. Biçim: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

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

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. 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 eşzamansız olarak hesaplanan bilgiler.

Özellikler

CSS ürününün özellikleri.

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,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
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ık fiyatı.

headlineOfferShippingPrice

object (Price)

CSS ürününün başlık fiyatı.

productTypes[]

string

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

sizeTypes[]

string

Öğenin kesimi. Giyim ürünleri için birleştirilmiş beden türlerini temsil etmek amacıyla kullanılabilir. En fazla iki beden türü sağlanabilir (beden türü bölümüne bakın).

productDetails[]

object (ProductDetail)

Teknik özellikler veya ek ürün ayrıntıları.

productWeight

object (ProductWeight)

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

productLength

object (ProductDimension)

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

productWidth

object (ProductDimension)

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

productHeight

object (ProductDimension)

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

productHighlights[]

string

Bir ürünün öne çıkan özelliklerinden en alakalı olanları açıklayan madde işaretleri.

certifications[]

object (Certification)

CSS tarafından belirli bir ürün için talep edilen 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 geçerlilik bitiş tarihi, productstatuses içinde googleExpirationDate olarak gösterilir ve expirationDate çok ilerideyse daha erken olabilir. Not: Öğenin geçerlilik bitiş tarihinden 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.

Desteklenen değerler: - css_ads_experiences - css_organic_experiences

excludedDestinations[]

string

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

Desteklenen değerler: - css_ads_experiences - css_organic_experiences

headlineOfferInstallment

object (HeadlineOfferInstallment)

Bir ürün 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, ürün reklamları bağlamında gösterildiğinde reklamverenlerin öğe URL'sini geçersiz kılmasına olanak tanır.

numberOfOffers

string (int64 format)

CSS ürünlerinin 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

Öğenin Google kategorisi (Google ürün sınıflandırması bölümüne bakın). Ürünler sorgulanırken bu alan, kullanıcı tarafından sağlanan değeri içerir. Şu anda otomatik olarak atanan Google ürün kategorilerini API üzerinden geri almanın bir yolu yoktur.

adult

boolean

Öğe yetişkinlere yönelikse "true" değerine ayarlayın.

multipack

string (int64 format)

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

isBundle

boolean

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

ageGroup

string

Öğeyle hedeflenen yaş grubu.

color

string

Öğenin rengi.

gender

string

Öğenin hedeflediği cinsiyet.

material

string

Öğenin yapıldığı malzeme.

pattern

string

Öğenin deseni (ör. puantiyeli).

size

string

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

sizeSystem

string

Bedenin belirtildiği sistem. Giyim ürünleri için önerilir.

itemGroupId

string

Aynı ürünün tüm varyantları için ortak tanımlayıcı.

pause

string

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

customLabel0

string

Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 0.

customLabel1

string

Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 1.

customLabel2

string

Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 2.

customLabel3

string

Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 3.

customLabel4

string

Alışveriş kampanyasındaki öğelerin özel gruplandırması için özel etiket 4.

reviewCount

string (int64 format)

Ürünle ilgili yorumların sayısı. rating sağlanırsa zorunludur.

minRating

string (int64 format)

Ürünün minimum puanı. rating sağlanırsa zorunludur.

maxRating

string (int64 format)

Ürünün maksimum puanı. rating sağlanırsa zorunludur.

rating

number

Ürünün ortalama puanı. Değer, [minRating, maxRating] aralığında (başlangıç ve bitiş değerleri dahil) olmalıdır. Ürün sayfasında gösterilen bu puan, bir ondalık basamakla [1, 5] ölçeğine normalleştirilir. Sağlanırsa reviewCount, minRating ve maxRating de gereklidir.

Fiyat

Sayı ve para birimi olarak gösterilen fiyat.

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

string (int64 format)

Mikro cinsinden sayı olarak gösterilen 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 fiyatın para birimi.

ProductDetail

Ürün ayrıntıları.

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

string

Bir ürün ayrıntıları grubunu 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 temsil edilen 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 şunlardır: * "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 basamak hassasiyetine sahip olabilir.

unit

string

Zorunlu. Boyut birimleri. Kabul edilen değerler şunlardır: * "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 AB'deki enerji etiketleri için en yaygın değer "EC" veya "European_Commission"dır.

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. Avrupa Enerji Etiketleri için kod zorunludur.

HeadlineOfferInstallment

Taksiti 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 ödeme yapması 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 süresi.

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

CustomAttribute

Özel özellikleri temsil eden bir mesaj. value veya groupValues alanlarından yalnızca biri boş bırakılmalı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ün durumu, veri doğrulama sorunları, yani CSS ürünü hakkında eşzamansız olarak hesaplanan bilgiler.

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)

ISO 8601 biçiminde belirtilen, öğenin oluşturulduğu tarih.

lastUpdateDate

string (Timestamp format)

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

googleExpirationDate

string (Timestamp format)

Öğenin geçerlilik süresinin sona erdiği tarih (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 alfa-2) listesi.

pendingCountries[]

string

CSS ürününün onay beklediği ülke kodlarının (ISO 3166-1 alfa-2) listesi.

disapprovedCountries[]

string

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

ItemLevelIssue

Ürün durumunun ItemLevelIssue değeri.

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ü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

Sorunun İngilizce kısa açıklaması

detail

string

Sorunun İngilizce ayrıntılı açıklaması

documentation

string

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

applicableCountries[]

string

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

Yöntemler

get

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

list

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