REST Resource: accounts.cssProducts

Resource: CssProduct

Produk CSS yang diproses.

Representasi JSON
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Kolom
name

string

Nama Produk CSS. Format: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

Hanya output. ID mentah unik Anda untuk produk.

contentLanguage

string

Hanya output. Kode bahasa ISO 639-1 dua huruf untuk produk.

feedLabel

string

Hanya output. Label feed untuk produk.

attributes

object (Attributes)

Hanya output. Daftar atribut produk.

customAttributes[]

object (CustomAttribute)

Hanya output. Daftar atribut kustom (yang disediakan CSS). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi feed dalam bentuk generiknya (misalnya, { "name": "size type", "value": "regular" }). Hal ini berguna untuk mengirimkan atribut yang tidak secara eksplisit diekspos oleh API, seperti atribut tambahan yang digunakan untuk Beli dengan Google.

cssProductStatus

object (CssProductStatus)

Hanya output. Status produk, masalah validasi data, yaitu informasi tentang produk yang dihitung secara asinkron.

Atribut

Atribut untuk Produk CSS.

Representasi JSON
{
  "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
}
Kolom
lowPrice

object (Price)

Harga Rendah Produk CSS.

highPrice

object (Price)

Harga Tinggi Produk CSS.

headlineOfferPrice

object (Price)

Harga Headline Produk CSS.

headlineOfferShippingPrice

object (Price)

Harga Headline Produk CSS.

productTypes[]

string

Kategori item (diformat seperti dalam spesifikasi data produk).

sizeTypes[]

string

Potongan item. Dapat digunakan untuk merepresentasikan jenis ukuran gabungan untuk item pakaian. Maksimum dua jenis ukuran dapat diberikan (lihat jenis ukuran.

productDetails[]

object (ProductDetail)

Spesifikasi teknis atau detail produk tambahan.

productWeight

object (ProductWeight)

Berat produk dalam satuan yang diberikan. Nilai harus antara 0 (eksklusif) dan 2000 (inklusif).

productLength

object (ProductDimension)

Panjang produk dalam satuan yang diberikan. Nilai harus antara 0 (eksklusif) dan 3000 (inklusif).

productWidth

object (ProductDimension)

Lebar produk dalam satuan yang diberikan. Nilai harus antara 0 (eksklusif) dan 3000 (inklusif).

productHeight

object (ProductDimension)

Tinggi produk dalam satuan yang diberikan. Nilai harus antara 0 (eksklusif) dan 3000 (inklusif).

productHighlights[]

string

Poin-poin yang mendeskripsikan sorotan produk yang paling relevan.

certifications[]

object (Certification)

Daftar sertifikat yang diklaim oleh CSS untuk produk tertentu.

expirationDate

string (Timestamp format)

Tanggal item harus habis masa berlakunya, seperti yang ditentukan saat penyisipan, dalam format ISO 8601. Tanggal habis masa berlaku sebenarnya ditampilkan di productstatuses sebagai googleExpirationDate dan mungkin lebih awal jika expirationDate terlalu jauh di masa mendatang. Catatan: Mungkin perlu waktu 2+ hari sejak tanggal habis masa berlaku agar item benar-benar dihapus.

includedDestinations[]

string

Daftar tujuan yang akan disertakan untuk target ini (sesuai dengan kotak yang dicentang di Merchant Center). Tujuan default selalu disertakan kecuali jika diberikan dalam excludedDestinations.

excludedDestinations[]

string

Daftar tujuan yang akan dikecualikan untuk target ini (sesuai dengan kotak yang tidak dicentang di Merchant Center).

headlineOfferInstallment

object (HeadlineOfferInstallment)

Jumlah dan nilai cicilan yang harus dibayar untuk suatu item.

headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Jumlah periode (bulan atau tahun) dan jumlah pembayaran per periode untuk item dengan kontrak langganan terkait.

cppAdsRedirect

string

Memungkinkan pengiklan mengganti URL item saat produk ditampilkan dalam konteks Iklan Produk.

numberOfOffers

string (int64 format)

Jumlah Produk CSS.

headlineOfferCondition

string

Kondisi penawaran headline.

title

string

Judul item.

description

string

Deskripsi item.

brand

string

Atribut Terkait Produk.[14-36] Merek item.

mpn

string

Nomor Suku Cadang Produsen (MPN) item.

gtin

string

Nomor Barang Perdagangan Global (GTIN) item.

googleProductCategory

string

Kategori item Google (lihat taksonomi produk Google). Saat mengkueri produk, kolom ini akan berisi nilai yang diberikan pengguna. Saat ini, tidak ada cara untuk mendapatkan kembali kategori produk Google yang ditetapkan secara otomatis melalui API.

adult

boolean

Tetapkan ke true jika item ditargetkan untuk orang dewasa.

multipack

string (int64 format)

Jumlah produk identik dalam multipak yang ditentukan oleh penjual.

isBundle

boolean

Apakah item adalah paket yang ditentukan penjual. Paket adalah pengelompokan khusus berbagai produk yang dijual oleh penjual dengan satu harga.

ageGroup

string

Kelompok usia target untuk item.

color

string

Warna item.

gender

string

Gender target item.

material

string

Bahan yang digunakan untuk membuat item.

pattern

string

Pola item (misalnya, polka dot).

size

string

Ukuran item. Hanya satu nilai yang diizinkan. Untuk varian dengan ukuran yang berbeda, masukkan produk terpisah untuk setiap ukuran dengan nilai itemGroupId yang sama (lihat [https://support.google.com/merchants/answer/6324492](definisi ukuran)).

sizeSystem

string

Sistem yang digunakan untuk menentukan ukuran. Direkomendasikan untuk item pakaian.

itemGroupId

string

ID bersama untuk semua varian dari produk yang sama.

pause

string

Publikasi item ini akan dijeda sementara.

customLabel0

string

Label kustom 0 untuk pengelompokan item khusus dalam kampanye Shopping.

customLabel1

string

Label kustom 1 untuk pengelompokan item khusus dalam kampanye Shopping.

customLabel2

string

Label kustom 2 untuk pengelompokan item khusus dalam kampanye Shopping.

customLabel3

string

Label kustom 3 untuk pengelompokan item khusus dalam kampanye Shopping.

customLabel4

string

Label kustom 4 untuk pengelompokan item khusus dalam kampanye Shopping.

reviewCount

string (int64 format)

Jumlah ulasan produk. Wajib jika rating diberikan. Kolom ini ditujukan untuk fitur mendatang dan belum digunakan.

minRating

string (int64 format)

Skor rating minimum produk. Wajib jika rating diberikan. Kolom ini ditujukan untuk fitur mendatang dan belum digunakan.

maxRating

string (int64 format)

Skor rating maksimum produk. Wajib jika rating diberikan. Kolom ini ditujukan untuk fitur mendatang dan belum digunakan.

rating

number

Skor rating rata-rata produk. Nilai harus berada dalam rentang [minRating, maxRating], inklusif. Saat ditampilkan di halaman produk, rating ini dinormalisasi ke skala [1, 5] dengan satu tempat desimal. Jika diberikan, reviewCount, minRating, dan maxRating juga diperlukan. Kolom ini ditujukan untuk fitur mendatang dan belum digunakan.

Harga

Harga yang ditampilkan sebagai angka dan mata uang.

Representasi JSON
{
  "amountMicros": string,
  "currencyCode": string
}
Kolom
amountMicros

string (int64 format)

Harga ditampilkan sebagai angka dalam mikro (1 juta mikro setara dengan satu unit standar mata uang, misalnya, 1 USD = 1.000.000 mikro).

currencyCode

string

Mata uang harga menggunakan akronim tiga huruf sesuai dengan ISO 4217.

ProductDetail

Detail produk.

Representasi JSON
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Kolom
sectionName

string

Header bagian yang digunakan untuk mengelompokkan serangkaian detail produk.

attributeName

string

Nama detail produk.

attributeValue

string

Nilai detail produk.

ProductWeight

Berat produk.

Representasi JSON
{
  "value": number,
  "unit": string
}
Kolom
value

number

Wajib. Bobot yang ditampilkan sebagai angka. Bobot dapat memiliki presisi maksimum empat angka di belakang koma.

unit

string

Wajib. Satuan berat. Nilai yang dapat diterima adalah: * "g" * "kg" * "oz" * "lb"

ProductDimension

Dimensi produk.

Representasi JSON
{
  "value": number,
  "unit": string
}
Kolom
value

number

Wajib. Nilai dimensi yang ditampilkan sebagai angka. Nilai dapat memiliki presisi maksimum empat angka di belakang koma.

unit

string

Wajib. Satuan dimensi. Nilai yang dapat diterima adalah: * "in" * "cm"

Sertifikasi

Sertifikasi untuk produk. Gunakan atribut ini untuk mendeskripsikan sertifikasi, seperti rating efisiensi energi, yang terkait dengan produk.

Representasi JSON
{
  "name": string,
  "authority": string,
  "code": string
}
Kolom
name

string

Nama sertifikasi. Saat ini, nilai yang paling umum adalah "EPREL", yang mewakili sertifikasi efisiensi energi di database European Registry for Energy Labeling (EPREL) Uni Eropa.

authority

string

Otoritas atau lembaga sertifikasi yang bertanggung jawab atas penerbitan sertifikasi. Saat ini, nilai yang paling umum adalah "EC" atau “European_Commission” untuk label energi di Uni Eropa.

code

string

Kode sertifikasi. Misalnya, untuk sertifikat EPREL dengan link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, kodenya adalah 123456. Kode diwajibkan untuk Label Energi Eropa.

HeadlineOfferInstallment

Pesan yang mewakili cicilan.

Representasi JSON
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Kolom
months

string (int64 format)

Jumlah cicilan yang harus dibayar pembeli.

amount

object (Price)

Jumlah yang harus dibayar pembeli per bulan.

downpayment

object (Price)

Jumlah uang muka yang harus dibayar pembeli.

HeadlineOfferSubscriptionCost

SubscriptionCost produk.

Representasi JSON
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Kolom
period

enum (SubscriptionPeriod)

Jenis periode langganan. Nilai yang didukung adalah: * "month" * "year"

periodLength

string (int64 format)

Jumlah periode berlangganan yang harus dibayar pembeli.

amount

object (Price)

Jumlah yang harus dibayar pembeli per periode langganan.

SubscriptionPeriod

Periode langganan produk.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Menunjukkan bahwa periode langganan tidak ditentukan.
MONTH Menunjukkan bahwa periode langganan adalah bulanan.
YEAR Menunjukkan bahwa periode langganan adalah tahun.

CustomAttribute

Pesan yang merepresentasikan atribut kustom. Tepat satu dari value atau groupValues tidak boleh kosong.

Representasi JSON
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Kolom
groupValues[]

object (CustomAttribute)

Sub-atribut dalam grup atribut ini. Jika groupValues tidak kosong, value harus kosong.

name

string

Nama atribut.

value

string

Nilai atribut. Jika value tidak kosong, groupValues harus kosong.

CssProductStatus

Status Produk CSS, masalah validasi data, yaitu informasi tentang Produk CSS yang dihitung secara asinkron.

Representasi JSON
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Kolom
destinationStatuses[]

object (DestinationStatus)

Tujuan yang dimaksudkan untuk produk.

itemLevelIssues[]

object (ItemLevelIssue)

Daftar semua masalah yang terkait dengan produk.

creationDate

string (Timestamp format)

Tanggal saat item dibuat, dalam format ISO 8601.

lastUpdateDate

string (Timestamp format)

Tanggal saat item terakhir diperbarui, dalam format ISO 8601.

googleExpirationDate

string (Timestamp format)

Tanggal item berakhir, dalam format ISO 8601.

DestinationStatus

Status tujuan dari status produk.

Representasi JSON
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Kolom
destination

string

Nama tujuan

approvedCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat Produk CSS disetujui.

pendingCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat Produk CSS menunggu persetujuan.

disapprovedCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat Produk CSS tidak disetujui.

ItemLevelIssue

ItemLevelIssue status produk.

Representasi JSON
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Kolom
code

string

Kode error masalah.

servability

string

Pengaruh masalah ini terhadap penayangan Produk CSS.

resolution

string

Apakah masalah dapat diselesaikan oleh penjual atau tidak.

attribute

string

Nama atribut, jika masalahnya disebabkan oleh satu atribut.

destination

string

Tujuan tempat masalah diterapkan.

description

string

Deskripsi singkat masalah dalam bahasa Inggris.

detail

string

Deskripsi masalah mendetail dalam bahasa Inggris.

documentation

string

URL halaman web untuk membantu menyelesaikan masalah ini.

applicableCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat masalah berlaku untuk Produk CSS.

Metode

get

Mengambil Produk CSS yang diproses dari akun CSS Center Anda.

list

Mencantumkan Produk CSS yang diproses di akun CSS Center Anda.