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 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 kullanıma sunulmayan özellikleri (ör. Google ile Satın Al için kullanılan ek özellikler) göndermek için yararlıdır.

cssProductStatus

object (CssProductStatus)

Yalnızca çıkış. Bir ürünün durumu, veri doğrulama sorunları (yani bir ürünle ilgili 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,
  "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ı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ç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 (bkz. beden türü).

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 birimlerdeki yüksekliği. Değer 0 (hariç) ile 3.000 (dahil) arasında olmalıdır.

productHighlights[]

string

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

certifications[]

object (Certification)

CSS'nin söz konusu ürün için talep ettiği sertifikaların listesi.

expirationDate

string (Timestamp format)

Öğenin, ekleme sırasında belirtildiği şekilde geçerliliğinin sona ereceği tarih (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 gerçekten silinmesi, son kullanma tarihinden itibaren 2 veya daha fazla gün 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)

Abonelik sözleşmesiyle ilişkili bir öğe için dönem sayısı (ay veya yıl) ve dönem başına ödeme tutarı.

cppAdsRedirect

string

Reklamverenlerin, ürünün ürün reklamları bağlamında gösterilmesi durumunda öğe URL'sini geçersiz kılmasını sağlar.

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 (bkz. Google ürün sınıflandırması). Ürünler sorgulanırken bu alan, kullanıcı tarafından sağlanan değeri içerir. Şu anda API aracılığıyla otomatik olarak atanan Google ürün kategorilerini geri almanın bir yolu yoktur.

adult

boolean

Öğe yetişkinlere yönelikse true olarak ayarlayın.

multipack

string (int64 format)

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

isBundle

boolean

Öğenin satıcı tarafından tanımlanan bir paket olup olmadığı. Paket, bir satıcı tarafından tek 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 hedeflenen cinsiyeti.

material

string

Öğenin yapıldığı malzeme.

pattern

string

Öğenin deseni (ör. benekli).

size

string

Öğenin boyutu. Yalnızca bir değere izin verilir. Farklı bedenlere sahip 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ınlanması geçici olarak duraklatılacak.

customLabel0

string

Alışveriş kampanyasındaki öğelerin özel olarak gruplandırılması için kullanılan özel etiket 0.

customLabel1

string

Alışveriş kampanyasındaki öğelerin özel olarak gruplandırılması için kullanılan özel etiket 1.

customLabel2

string

Alışveriş kampanyasındaki öğelerin özel olarak gruplandırılması için kullanılan 2. özel etiket.

customLabel3

string

Alışveriş kampanyasındaki öğelerin özel olarak gruplandırılması için kullanılan 3. özel etiket.

customLabel4

string

Alışveriş kampanyasındaki öğelerin özel olarak gruplandırılması için kullanılan özel etiket 4.

reviewCount

string (int64 format)

Ürünün yorum sayısıdır. rating sağlanırsa zorunludur. Bu alan, yakında kullanıma sunulacak bir özellik için ayrılmıştır ve henüz kullanılmamaktadır.

minRating

string (int64 format)

Ürünün minimum puanı. rating sağlanırsa zorunludur. Bu alan, yakında kullanıma sunulacak bir özellik için ayrılmıştır ve henüz kullanılmamaktadır.

maxRating

string (int64 format)

Ürünün maksimum puanı. rating sağlanırsa zorunludur. Bu alan, yakında kullanıma sunulacak bir özellik için ayrılmıştır ve henüz kullanılmamaktadır.

rating

number

Ürünün ortalama puanı. Değer, [minRating, maxRating] aralığında (değerler dahil) olmalıdır. Ürün sayfasında gösterilen bu puan, bir ondalık basamakla [1, 5] ölçeğine göre normalleştirilir. Sağlanırsa reviewCount, minRating ve maxRating de gereklidir. Bu alan, yakında kullanıma sunulacak bir özellik için ayrılmıştır ve henüz kullanılmamaktadır.

Fiyat

Sayı ve para birimi olarak gösterilen fiyat.

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

string (int64 format)

Fiyat, mikro cinsinden bir sayı olarak gösterilir (1 milyon mikro, para biriminin standart birimine eşittir. Örneğin, 1 ABD doları = 1.000.000 mikro).

currencyCode

string

ISO 4217'ye göre üç harfli kısaltmalar kullanılarak belirtilen 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. Ağırlık sayı olarak gösterilir. 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. Boyut değeri sayı olarak gösterilir. Değerin hassasiyeti en fazla dört ondalık basamak 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ı (ör. enerji verimlilik dereceleri) 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" değeridir.

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'u.

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 dönemi.

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

CustomAttribute

Özel özellikleri temsil eden bir mesaj. Tam olarak value veya groupValues 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ün durumu, veri doğrulama sorunları (yani CSS ürünüyle ilgili 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 yerleri.

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 en son güncellendiği tarih (ISO 8601 biçiminde).

googleExpirationDate

string (Timestamp format)

Öğenin geçerliliğinin 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

Varış noktasının adı

approvedCountries[]

string

CSS ürünü için onay verilen ü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'su.

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

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

detail

string

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

documentation

string

Bu sorunu çözmeye 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

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

list

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