REST Resource: accounts.products

Resource: Produk

Produk yang diproses, yang dibuat dari beberapa [input produk][[google.shopping.content.bundles.Products.ProductInput] setelah menerapkan aturan dan sumber data tambahan. Produk yang diproses ini cocok dengan yang ditampilkan di akun Merchant Center Anda dan di iklan Shopping serta platform Google lainnya. Setiap produk dibuat dari satu input produk sumber data utama, dan beberapa input sumber data tambahan. Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk diproses yang diperbarui dapat diambil.

Semua kolom dalam produk yang diproses dan sub-pesannya cocok dengan nama atribut yang sesuai dalam Spesifikasi data produk dengan beberapa pengecualian.

Representasi JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Kolom
name

string

Nama produk. Format: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Hanya output. Saluran produk.
offerId

string

Hanya output. ID unik produk. Ini sama dengan input produk dan produk yang diproses. Spasi di awal dan di akhir akan dihapus dan beberapa spasi kosong akan diganti dengan satu spasi kosong saat pengiriman. Lihat spesifikasi data produk untuk mengetahui detailnya.
contentLanguage

string

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

string

Hanya output. Label feed untuk produk.
dataSource

string

Hanya output. Sumber data utama produk.
attributes

object (Attributes)

Hanya output. Daftar atribut produk.
customAttributes[]

object (CustomAttribute)

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

object (ProductStatus)

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

string (int64 format)

Hanya output. Mewakili versi (keaktualan) produk yang ada, yang dapat digunakan untuk mempertahankan urutan yang benar saat beberapa update dilakukan secara bersamaan.

Jika ditetapkan, penyisipan akan dicegah jika nomor versi lebih rendah dari nomor versi produk yang sudah ada saat ini. Penyisipan ulang (misalnya, pembaruan produk setelah 30 hari) dapat dilakukan dengan versionNumber saat ini.

Hanya didukung untuk penyisipan ke sumber data utama.

Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan.

Atribut

Atribut.

Representasi JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Kolom
expirationDate

string (Timestamp format)

Tanggal item akan habis masa berlakunya, seperti yang ditentukan saat penyisipan, dalam format ISO 8601. Tanggal habis masa berlaku yang sebenarnya ditampilkan di productstatuses sebagai googleExpirationDate dan mungkin lebih awal jika expirationDate masih terlalu jauh di masa mendatang.
disclosureDate

string (Timestamp format)

Tanggal saat penawaran terlihat di hasil penelusuran di seluruh platform YouTube Google, dalam format ISO 8601. Lihat [Tanggal pengungkapan]( https://support.google.com/merchants/answer/13034208) untuk mengetahui informasi selengkapnya.
availabilityDate

string (Timestamp format)

Hari saat produk praorder tersedia untuk dikirim, dalam format ISO 8601.
price

object (Price)

Harga item.
installment

object (Installment)

Jumlah dan jumlah cicilan untuk membayar item.
subscriptionCost

object (SubscriptionCost)

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

object (LoyaltyPoints)

Poin loyalitas yang diterima pengguna setelah membeli item. khusus Jepang.
loyaltyPrograms[]

object (LoyaltyProgram)

Daftar informasi program loyalitas yang digunakan untuk menampilkan manfaat loyalitas (misalnya, harga yang lebih baik, poin, dll.) kepada pengguna item ini.
productTypes[]

string

Kategori item (diformat seperti pada spesifikasi data produk).
salePrice

object (Price)

Harga promo item yang diiklankan.
salePriceEffectiveDate

object (Interval)

Rentang tanggal saat item dijual (lihat spesifikasi data produk).
productHeight

object (ProductDimension)

Tinggi produk dalam unit yang disediakan. Nilai harus antara 0 (eksklusif) dan 3.000 (inklusif).
productLength

object (ProductDimension)

Panjang produk dalam unit yang disediakan. Nilai harus antara 0 (eksklusif) dan 3.000 (inklusif).
productWidth

object (ProductDimension)

Lebar produk dalam unit yang disediakan. Nilai harus antara 0 (eksklusif) dan 3.000 (inklusif).
productWeight

object (ProductWeight)

Berat produk dalam unit yang diberikan. Nilainya harus antara 0 (eksklusif) dan 2.000 (inklusif).
shipping[]

object (Shipping)

Aturan pengiriman.
freeShippingThreshold[]

object (FreeShippingThreshold)

Ketentuan yang harus dipenuhi agar produk mendapatkan pengiriman gratis.
shippingWeight

object (ShippingWeight)

Berat item untuk pengiriman.
shippingLength

object (ShippingDimension)

Panjang item untuk pengiriman.
shippingWidth

object (ShippingDimension)

Lebar item untuk pengiriman.
shippingHeight

object (ShippingDimension)

Tinggi item yang akan dikirim.
sizeTypes[]

string

Potongan item. Dapat digunakan untuk merepresentasikan tipe ukuran gabungan untuk item pakaian. Maksimum dua jenis ukuran dapat diberikan (lihat [https://support.google.com/merchants/answer/6324497](jenis ukuran)).
taxes[]

object (Tax)

Informasi pajak.
unitPricingMeasure

object (UnitPricingMeasure)

Ukuran dan dimensi item.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

Preferensi penyebut harga unit.
adsLabels[]

string

Serupa dengan adsGrouping, tetapi hanya berfungsi pada CPC.
costOfGoodsSold

object (Price)

Harga pokok penjualan. Digunakan untuk pelaporan laba kotor.
productDetails[]

object (ProductDetail)

Spesifikasi teknis atau detail produk tambahan.
productHighlights[]

string

Poin-poin yang menjelaskan highlight produk yang paling relevan.
displayAdsSimilarIds[]

string

Rekomendasi yang ditentukan pengiklan.
promotionIds[]

string

ID unik promosi.
includedDestinations[]

string

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

string

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

string

Daftar kode negara (ISO 3166-1 alpha-2) untuk mengecualikan penawaran dari tujuan Iklan Shopping. Negara dari daftar ini dihapus dari negara yang dikonfigurasi di setelan sumber data.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Kolom tambahan untuk diekspor ke program Retail Cloud.
certifications[]

object (Certification)

Sertifikasi Produk, misalnya untuk pelabelan efisiensi energi produk yang dicatat dalam database EU EPREL. Lihat artikel Pusat Bantuan untuk informasi selengkapnya.
autoPricingMinPrice

object (Price)

Pengamanan dalam project "Diskon Otomatis" (https://support.google.com/merchants/answer/10295759) dan "Promosi Dinamis" (https://support.google.com/merchants/answer/13949249), memastikan bahwa diskon pada penawaran penjual tidak berada di bawah nilai ini, sehingga mempertahankan nilai dan profitabilitas penawaran.
identifierExists

boolean

Tetapkan nilai ini ke salah jika item tidak memiliki kode unik produk yang sesuai dengan kategorinya, seperti GTIN, MPN, dan merek. Nilai defaultnya adalah true (benar), jika tidak disediakan.
isBundle

boolean

Apakah item tersebut merupakan paket yang ditentukan penjual. Paket adalah pengelompokan kustom dari berbagai produk yang dijual oleh penjual dengan satu harga.
title

string

Judul item.
description

string

Deskripsi item.
adult

boolean

Tetapkan ke true jika item ditargetkan untuk orang dewasa.
ageGroup

string

Kelompok usia target item.
availability

string

Status ketersediaan item.
brand

string

Merek item.
color

string

Warna item.
condition

string

Kondisi atau status item.
gender

string

Gender target item.
googleProductCategory

string

Kategori item Google (lihat taksonomi produk Google). Saat membuat kueri 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.
gtin

string

Nomor Barang Perdagangan Global (GTIN) item tersebut.
itemGroupId

string

ID bersama untuk semua varian dari produk yang sama.
material

string

Bahan yang digunakan untuk membuat item.
mpn

string

Nomor Suku Cadang Produsen (MPN) item.
pattern

string

Pola item (misalnya, polka dot).
sellOnGoogleQuantity

string (int64 format)

Jumlah produk yang tersedia untuk dijual di Google. Hanya didukung untuk produk online.
maxHandlingTime

string (int64 format)

Waktu pemrosesan produk maksimal (dalam hari kerja).
minHandlingTime

string (int64 format)

Waktu pemrosesan produk minimal (dalam hari kerja).
shippingLabel

string

Label pengiriman produk, digunakan untuk mengelompokkan produk dalam aturan pengiriman tingkat akun.
transitTimeLabel

string

Label waktu transit produk, yang digunakan untuk mengelompokkan produk dalam tabel waktu transit tingkat akun.
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 menentukan ukuran. Direkomendasikan untuk item pakaian.
taxCategory

string

Kategori pajak produk, yang digunakan untuk mengonfigurasi nexus pajak terperinci di setelan pajak tingkat akun.
energyEfficiencyClass

string

Tingkat efisiensi energi sebagaimana ditetapkan dalam pedoman Uni Eropa 2010/30/EU.
minEnergyEfficiencyClass

string

Tingkat efisiensi energi sebagaimana ditetapkan dalam pedoman Uni Eropa 2010/30/EU.
maxEnergyEfficiencyClass

string

Tingkat efisiensi energi sebagaimana ditetapkan dalam pedoman Uni Eropa 2010/30/EU.
multipack

string (int64 format)

Jumlah produk yang sama dalam multipak yang ditentukan oleh penjual.
adsGrouping

string

Digunakan untuk mengelompokkan item dengan cara arbitrer. Hanya untuk CPA%, tidak disarankan sebaliknya.
adsRedirect

string

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

string

ID item untuk kampanye pemasaran ulang dinamis.
displayAdsTitle

string

Judul item untuk kampanye pemasaran ulang dinamis.
displayAdsValue

number

Margin penawaran untuk kampanye pemasaran ulang dinamis.
pickupMethod

string

Opsi pengambilan untuk item.
pickupSla

string

Linimasa pengambilan item di toko.
customLabel0

string

Label kustom 0 untuk pengelompokan kustom item dalam kampanye Shopping.
customLabel1

string

Label kustom 1 untuk pengelompokan kustom item dalam kampanye Shopping.
customLabel2

string

Label kustom 2 untuk pengelompokan kustom item dalam kampanye Shopping.
customLabel3

string

Label kustom 3 untuk pengelompokan kustom item dalam kampanye Shopping.
customLabel4

string

Label kustom 4 untuk pengelompokan kustom item dalam kampanye Shopping.
externalSellerId

string

Wajib untuk akun multi-penjual. Gunakan atribut ini jika Anda adalah marketplace yang mengupload produk untuk berbagai penjual ke akun multi-penjual Anda.
pause

string

Publikasi item ini akan dijeda untuk sementara.
structuredTitle

object (ProductStructuredTitle)

Judul terstruktur, untuk judul yang dibuat berdasarkan algoritma (AI).
structuredDescription

object (ProductStructuredDescription)

Deskripsi terstruktur, untuk deskripsi yang dibuat berdasarkan algoritma (AI).

Cicilan

Pesan yang mewakili cicilan.

Representasi JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
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.
creditType

string

Jenis pembayaran cicilan. Nilai yang didukung adalah: * "finance" * "lease"

SubscriptionCost

Biaya Langganan 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 langganan 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 bulan.
YEAR Menunjukkan bahwa periode langganan adalah tahun.

LoyaltyPoints

Pesan yang mewakili poin loyalitas.

Representasi JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Kolom
name

string

Nama program poin loyalitas. Sebaiknya batasi nama maksimal hingga 12 karakter lebar penuh atau 24 karakter Romawi.
pointsValue

string (int64 format)

Poin loyalitas retailer dalam nilai absolut.
ratio

number

Rasio poin jika dikonversikan ke mata uang. Google mengasumsikan mata uang berdasarkan setelan Merchant Center. Jika tidak disertakan, rasio defaultnya adalah 1,0.

LoyaltyProgram

Pesan yang mewakili program loyalitas.

Representasi JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Kolom
programLabel

string

Label program loyalitas. Ini adalah label internal yang mengidentifikasi hubungan antara entitas penjual dan entitas program loyalitas secara unik. Label harus diberikan agar sistem dapat mengaitkan aset di bawah (misalnya, harga dan poin) dengan penjual. Program yang sesuai harus ditautkan ke akun penjual.
tierLabel

string

Label tingkat dalam program loyalitas. Harus cocok dengan salah satu label dalam program.
price

object (Price)

Harga untuk pelanggan tingkat tertentu, yaitu harga diskon langsung. Harus lebih kecil atau sama dengan harga reguler.
cashbackForFutureUse

object (Price)

Cashback yang dapat digunakan untuk pembelian di masa mendatang.
loyaltyPoints

string (int64 format)

Jumlah poin loyalitas yang diperoleh dari pembelian.

ProductDimension

Dimensi produk.

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

number

Wajib. Nilai dimensi direpresentasikan sebagai angka. Nilai ini dapat memiliki presisi maksimum empat angka desimal.
unit

string

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

ProductWeight

Berat produk.

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

number

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

string

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

Pengiriman

Pengiriman produk.

Representasi JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Kolom
price

object (Price)

Harga pengiriman tetap, direpresentasikan sebagai angka.
country

string

Kode wilayah CLDR untuk negara tujuan pengiriman item.
region

string

Wilayah geografis tempat tarif pengiriman berlaku. Lihat wilayah untuk mengetahui informasi selengkapnya.
service

string

Deskripsi bentuk bebas tentang kelas layanan atau kecepatan pengiriman.
locationId

string (int64 format)

ID numerik lokasi tempat tarif pengiriman berlaku seperti yang ditentukan dalam AdWords API.
locationGroupName

string

Lokasi tempat pengiriman berlaku, yang diwakili oleh nama grup lokasi.
postalCode

string

Rentang kode pos tempat tarif pengiriman berlaku, yang diwakili oleh kode pos, awalan kode pos diikuti dengan karakter pengganti *, rentang antara dua kode pos atau dua awalan kode pos yang panjangnya sama.
minHandlingTime

string (int64 format)

Waktu pemrosesan minimum (termasuk) antara saat pesanan diterima dan dikirim dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan saat diterima jika terjadi sebelum batas waktu. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] hanya dapat ada bersama dengan [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; tetapi tidak diperlukan jika terdapat [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
maxHandlingTime

string (int64 format)

Waktu pemrosesan maksimum (termasuk) antara saat pesanan diterima dan dikirim dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan saat diterima jika terjadi sebelum batas waktu. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] dan [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] diperlukan untuk memberikan kecepatan pengiriman. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] bersifat opsional jika terdapat [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
minTransitTime

string (int64 format)

Waktu transit minimum (termasuk) antara saat pesanan dikirim hingga diantarkan dalam hari kerja. 0 artinya pesanan dikirim pada hari yang sama saat pesanan dikirim. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] hanya dapat diberikan bersama dengan [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; tetapi tidak diwajibkan jika terdapat [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].
maxTransitTime

string (int64 format)

Waktu transit maksimum (termasuk) antara saat pesanan dikirim hingga tiba di hari kerja. 0 artinya pesanan dikirim pada hari yang sama saat pesanan dikirim. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] dan [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] diperlukan untuk memberikan kecepatan pengiriman. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] bersifat opsional jika [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] ada.

FreeShippingThreshold

Ketentuan yang harus dipenuhi agar produk mendapatkan pengiriman gratis.

Representasi JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Kolom
country

string

Kode wilayah CLDR untuk negara tujuan pengiriman item.
priceThreshold

object (Price)

Harga produk minimum agar biaya pengiriman menjadi gratis. Direpresentasikan sebagai angka.

ShippingWeight

Berat Pengiriman produk.

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

number

Berat produk yang digunakan untuk menghitung biaya pengiriman item.
unit

string

Satuan nilai.

ShippingDimension

Dimensi Pengiriman produk.

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

number

Dimensi produk yang digunakan untuk menghitung biaya pengiriman item.
unit

string

Satuan nilai.

Pajak

Pajak produk.

Representasi JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Kolom
rate

number

Persentase tarif pajak yang berlaku untuk harga item.
country

string

Negara tempat item dikenakan pajak, yang ditentukan sebagai kode wilayah CLDR.
region

string

Wilayah geografis tempat tarif pajak berlaku.
taxShip

boolean

Tetapkan ke true jika pajak dikenakan pada pengiriman.
locationId

string (int64 format)

ID numerik lokasi tempat tarif pajak berlaku seperti yang ditetapkan dalam AdWords API.
postalCode

string

Rentang kode pos tempat tarif pajak berlaku, yang diwakili oleh kode pos, awalan kode pos yang menggunakan karakter pengganti *, rentang antara dua kode pos atau dua awalan kode pos yang panjangnya sama. Contoh: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

UnitPricingMengukur produk.

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

number

Ukuran item.
unit

string

Satuan ukuran.

UnitPricingBaseMeasure

UnitPricingBaseMeasurement produk.

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

string (int64 format)

Penyebut dari harga unit.
unit

string

Satuan penyebut.

ProductDetail

Detail produk.

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

string

Header bagian yang digunakan untuk mengelompokkan kumpulan detail produk.
attributeName

string

Nama detail produk.
attributeValue

string

Nilai detail produk.

CloudExportAdditionalProperties

Properti produk untuk Cloud Retail API. Misalnya, properti untuk produk TV dapat berupa "Resolusi Layar" atau "Ukuran Layar".

Representasi JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Kolom
textValue[]

string

Nilai teks dari properti yang diberikan. Misalnya, "8K(UHD)" dapat berupa nilai teks untuk produk TV. Pengulangan maksimum nilai ini adalah 400. Nilai disimpan dalam urutan yang arbitrer namun konsisten. Ukuran string maksimum adalah 256 karakter.
intValue[]

string (int64 format)

Nilai bilangan bulat dari properti yang diberikan. Misalnya, 1080 untuk Resolusi Layar produk TV. Pengulangan maksimum nilai ini adalah 400. Nilai disimpan dalam urutan yang arbitrer namun konsisten.
floatValue[]

number

Nilai {i>float<i} dari properti yang diberikan. Misalnya untuk produk TV 1.2345. Pengulangan maksimum nilai ini adalah 400. Nilai disimpan dalam urutan yang arbitrer namun konsisten.
propertyName

string

Nama properti yang ditentukan. Misalnya, "Resolusi Layar" untuk produk TV. Ukuran string maksimum adalah 256 karakter.
boolValue

boolean

Nilai boolean dari properti yang diberikan. Misalnya, untuk produk TV, pilih "Benar" atau "Salah" jika layarnya UHD.
minValue

number

Nilai float minimum dari properti yang ditentukan. Misalnya untuk produk TV 1.00.
maxValue

number

Nilai float maksimum dari properti yang ditentukan. Misalnya untuk produk TV 100.00.
unitCode

string

Satuan properti yang ditentukan. Misalnya, "Piksel" untuk produk TV. Ukuran string maksimum adalah 256 B.

Sertifikasi

Sertifikasi produk, awalnya diperkenalkan untuk kepatuhan pelabelan efisiensi energi Uni Eropa menggunakan database EPREL Uni Eropa.

Representasi JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Kolom
certificationAuthority

string

Otoritas sertifikasi, misalnya "European_Commission". Panjang maksimum adalah 2.000 karakter.
certificationName

string

Nama sertifikasi, misalnya "EPREL". Panjang maksimum adalah 2.000 karakter.
certificationCode

string

Kode sertifikasi. Panjang maksimum adalah 2.000 karakter.
certificationValue

string

Nilai sertifikasi (juga dikenal sebagai class, level, atau nilai), misalnya "A+", "C", "gold". Panjang maksimum adalah 2.000 karakter.

ProductStructuredTitle

Judul terstruktur, untuk judul yang dibuat berdasarkan algoritma (AI).

Representasi JSON 
{
  "digitalSourceType": string,
  "content": string
}
Kolom
digitalSourceType

string

Jenis sumber digital, misalnya "trained_algorithmic_media". Mengikuti IPTC. Panjang maksimum adalah 40 karakter.
content

string

Teks judul Panjang maksimum adalah 150 karakter

ProductStructuredDescription

Deskripsi terstruktur, untuk deskripsi yang dibuat berdasarkan algoritma (AI).

Representasi JSON 
{
  "digitalSourceType": string,
  "content": string
}
Kolom
digitalSourceType

string

Jenis sumber digital, misalnya "trained_algorithmic_media". Mengikuti IPTC. Panjang maksimum adalah 40 karakter.
content

string

Panjang maksimum teks deskripsi adalah 5.000 karakter

ProductStatus

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

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

object (DestinationStatus)

Tujuan yang dimaksud untuk produk.
itemLevelIssues[]

object (ItemLevelIssue)

Daftar semua masalah yang terkait dengan produk.
creationDate

string (Timestamp format)

Tanggal item dibuat, dalam format ISO 8601.
lastUpdateDate

string (Timestamp format)

Tanggal 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 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Kolom
reportingContext

enum (ReportingContextEnum)

Nama konteks pelaporan.
approvedCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat penawaran disetujui.
pendingCountries[]

string

Daftar kode negara (ISO 3166-1 alpha-2) tempat penawaran menunggu persetujuan.
disapprovedCountries[]

string

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

ItemLevelIssue

ItemLevelIssue status produk.

Representasi JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Kolom
code

string

Kode error masalah.
severity

enum (Severity)

Pengaruh masalah ini terhadap penayangan penawaran.
resolution

string

Apakah masalah dapat diselesaikan oleh penjual.
attribute

string

Nama atribut, jika masalah disebabkan oleh satu atribut.
reportingContext

enum (ReportingContextEnum)

Konteks pelaporan tempat masalah berlaku.
description

string

Deskripsi masalah singkat 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 penawaran.

Tingkat keparahan

Bagaimana masalah tersebut memengaruhi penayangan produk.

Enum
SEVERITY_UNSPECIFIED Tidak ditentukan.
NOT_IMPACTED Masalah ini merupakan peringatan dan tidak berdampak langsung pada produk.
DEMOTED Produk tersebut didemosikan dan kemungkinan besar memiliki performa terbatas di hasil penelusuran
DISAPPROVED Masalah menolak produk.

Metode

get

 Mengambil produk yang diproses dari akun Merchant Center Anda.

list

 Mencantumkan produk yang diproses di akun Merchant Center Anda.