Package google.shopping.merchant.products.v1beta

Indeks

ProductInputsService

Layanan untuk menggunakan resource ProductInput. Layanan ini hanya berfungsi untuk produk dengan saluran online.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Menghapus input produk dari akun Merchant Center Anda.

Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/content

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Mengupload input produk ke akun Merchant Center Anda. Jika input dengan contentLanguage, offerId, dan dataSource yang sama sudah ada, metode ini akan menggantikan entri tersebut.

Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/content

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ProductsService

Layanan untuk menggunakan resource Produk. Layanan ini hanya berfungsi untuk produk dengan saluran online.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Mengambil produk yang diproses dari akun Merchant Center Anda.

Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk akhir yang diperbarui dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/content

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Mencantumkan produk yang diproses di akun Merchant Center Anda. Respons mungkin berisi lebih sedikit item dari yang ditentukan oleh pageSize. Mengandalkan pageToken untuk menentukan apakah ada item lain yang akan diminta.

Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk diproses yang diperbarui dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/content

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Atribut

Atribut.

Kolom
expiration_date

Timestamp

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.
disclosure_date

Timestamp

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.
availability_date

Timestamp

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

Price

Harga item.
installment

Installment

Jumlah dan jumlah cicilan untuk membayar item.
subscription_cost

SubscriptionCost

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

LoyaltyPoints

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

LoyaltyProgram

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

string

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

Price

Harga promo item yang diiklankan.
sale_price_effective_date

Interval

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

Aturan pengiriman.
free_shipping_threshold[]

FreeShippingThreshold

Ketentuan yang harus dipenuhi agar produk mendapatkan pengiriman gratis.
shipping_weight

ShippingWeight

Berat item untuk pengiriman.
shipping_length

ShippingDimension

Panjang item untuk pengiriman.
shipping_width

ShippingDimension

Lebar item untuk pengiriman.
shipping_height

ShippingDimension

Tinggi item yang akan dikirim.
size_types[]

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[]

Tax

Informasi pajak.
unit_pricing_measure

UnitPricingMeasure

Ukuran dan dimensi item.
unit_pricing_base_measure

UnitPricingBaseMeasure

Preferensi penyebut harga unit.
ads_labels[]

string

Serupa dengan ads_grouping, tetapi hanya berfungsi pada CPC.
cost_of_goods_sold

Price

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

ProductDetail

Spesifikasi teknis atau detail produk tambahan.
product_highlights[]

string

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

string

Rekomendasi yang ditentukan pengiklan.
promotion_ids[]

string

ID unik promosi.
included_destinations[]

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.
excluded_destinations[]

string

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

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.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

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

Certification

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

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.
identifier_exists

bool

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.
is_bundle

bool

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

bool

Tetapkan ke true jika item ditargetkan untuk orang dewasa.
age_group

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.
google_product_category

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.
item_group_id

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).
sell_on_google_quantity

int64

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

int64

Waktu pemrosesan produk maksimal (dalam hari kerja).
min_handling_time

int64

Waktu pemrosesan produk minimal (dalam hari kerja).
shipping_label

string

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

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)).
size_system

string

Sistem yang menentukan ukuran. Direkomendasikan untuk item pakaian.
tax_category

string

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

ID item untuk kampanye pemasaran ulang dinamis.
display_ads_title

string

Judul item untuk kampanye pemasaran ulang dinamis.
display_ads_value

double

Margin penawaran untuk kampanye pemasaran ulang dinamis.
pickup_method

string

Opsi pengambilan untuk item.
pickup_sla

string

Linimasa pengambilan item di toko.
custom_label_0

string

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

string

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

string

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

string

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

string

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

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.
structured_title

ProductStructuredTitle

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

ProductStructuredDescription

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

Sertifikasi

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

Kolom
certification_authority

string

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

string

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

string

Kode sertifikasi. Panjang maksimum adalah 2.000 karakter.
certification_value

string

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

CloudExportAdditionalProperties

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

Kolom
text_value[]

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.
int_value[]

int64

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.
float_value[]

float

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.
property_name

string

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

bool

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

float

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

float

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

string

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

DeleteProductInputRequest

Pesan permintaan untuk metode DeleteProductInput.

Kolom
name

string

Wajib. Nama resource input produk yang akan dihapus. Format: accounts/{account}/productInputs/{product}
data_source

string

Wajib. Sumber data utama atau tambahan tempat input produk harus dihapus. Format: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Ketentuan yang harus dipenuhi agar produk mendapatkan pengiriman gratis.

Kolom
country

string

Kode wilayah CLDR untuk negara tujuan pengiriman item.
price_threshold

Price

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

GetProductRequest

Pesan permintaan untuk metode GetProduct.

Kolom
name

string

Wajib. Nama produk yang akan diambil. Format: accounts/{account}/products/{product}

InsertProductInputRequest

Pesan permintaan untuk metode InsertProductInput.

Kolom
parent

string

Wajib. Akun tempat produk ini akan dimasukkan. Format: accounts/{account}
product_input

ProductInput

Wajib. Input produk yang akan disisipkan.
data_source

string

Wajib. Nama sumber data produk utama atau tambahan. Jika produk sudah ada dan sumber data yang diberikan berbeda, produk tersebut akan dipindahkan ke sumber data baru. Format: accounts/{account}/dataSources/{datasource}.

Cicilan

Pesan yang mewakili cicilan.

Kolom
months

int64

Jumlah cicilan yang harus dibayar pembeli.
amount

Price

Jumlah yang harus dibayar pembeli per bulan.
downpayment

Price

Jumlah uang muka yang harus dibayar pembeli.
credit_type

string

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

ListProductsRequest

Pesan permintaan untuk metode ListProducts.

Kolom
parent

string

Wajib. Akun untuk mencantumkan produk yang diproses. Format: accounts/{account}
page_size

int32

Jumlah maksimum produk yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000. Jika tidak ditentukan, jumlah maksimum produk akan ditampilkan.
page_token

string

Token halaman, yang diterima dari panggilan ListProducts sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListProducts harus cocok dengan panggilan yang menyediakan token halaman.

ListProductsResponse

Pesan respons untuk metode ListProducts.

Kolom
products[]

Product

Produk yang diproses dari akun yang ditentukan. Ini adalah produk yang diproses setelah menerapkan aturan dan sumber data tambahan.
next_page_token

string

Token, yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

LoyaltyPoints

Pesan yang mewakili poin loyalitas.

Kolom
name

string

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

int64

Poin loyalitas retailer dalam nilai absolut.
ratio

double

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.

Kolom
program_label

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.
tier_label

string

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

Price

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

Price

Cashback yang dapat digunakan untuk pembelian di masa mendatang.
loyalty_points

int64

Jumlah poin loyalitas yang diperoleh dari pembelian.

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.

Kolom
name

string

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

ChannelEnum

Hanya output. Saluran produk.
offer_id

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.
content_language

string

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

string

Hanya output. Label feed untuk produk.
data_source

string

Hanya output. Sumber data utama produk.
attributes

Attributes

Hanya output. Daftar atribut produk.
custom_attributes[]

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.
product_status

ProductStatus

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

int64

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 version_number saat ini.

Hanya didukung untuk penyisipan ke sumber data utama.

Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan.

ProductDetail

Detail produk.

Kolom
section_name

string

Header bagian yang digunakan untuk mengelompokkan kumpulan detail produk.
attribute_name

string

Nama detail produk.
attribute_value

string

Nilai detail produk.

ProductDimension

Dimensi produk.

Kolom
value

double

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"

ProductInput

Resource ini menunjukkan data input yang Anda kirimkan untuk suatu produk, bukan produk yang diproses yang Anda lihat di Merchant Center, di iklan Shopping, atau di seluruh platform Google. Input produk, aturan, dan data sumber data tambahan digabungkan untuk membuat [product][google.shopping.content.bundles.Products.Product] yang diproses.

Atribut input produk yang diperlukan untuk lulus pemeriksaan validasi data terutama didefinisikan dalam Spesifikasi Data Produk.

Atribut berikut wajib ada: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] dan [offerId][google.shopping.content.bundles.Products.offer_id].

Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.

Semua kolom dalam input produk dan sub-pesannya cocok dengan nama bahasa Inggris dari atribut yang sesuai di spesifikasi vertical dengan beberapa pengecualian.

Kolom
name

string

ID. Nama input produk. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

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

ChannelEnum

Wajib. Tidak dapat diubah. Saluran produk.
offer_id

string

Wajib. Tidak dapat diubah. 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.
content_language

string

Wajib. Tidak dapat diubah. Kode bahasa dua huruf ISO 639-1 untuk produk.
feed_label

string

Wajib. Tidak dapat diubah. Label feed untuk produk.
attributes

Attributes

Opsional. Daftar atribut produk.
custom_attributes[]

CustomAttribute

Opsional. 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. Jumlah karakter maksimum yang diizinkan untuk setiap atribut khusus adalah 10240 (mewakili jumlah karakter untuk nama dan nilai). Maksimum 2.500 atribut khusus dapat ditetapkan per produk, dengan ukuran total 102,4 kB. Garis bawah pada nama atribut khusus diganti dengan spasi saat penyisipan.
version_number

int64

Opsional. 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 version_number saat ini.

Hanya didukung untuk penyisipan ke sumber data utama.

Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan.

ProductStatus

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

Kolom
destination_statuses[]

DestinationStatus

Tujuan yang dimaksud untuk produk.
item_level_issues[]

ItemLevelIssue

Daftar semua masalah yang terkait dengan produk.
creation_date

Timestamp

Tanggal item dibuat, dalam format ISO 8601.
last_update_date

Timestamp

Tanggal item terakhir diperbarui, dalam format ISO 8601.
google_expiration_date

Timestamp

Tanggal item berakhir, dalam format ISO 8601.

DestinationStatus

Status tujuan dari status produk.

Kolom
reporting_context

ReportingContextEnum

Nama konteks pelaporan.
approved_countries[]

string

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

string

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

string

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

ItemLevelIssue

ItemLevelIssue status produk.

Kolom
code

string

Kode error masalah.
severity

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.
reporting_context

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.
applicable_countries[]

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.

ProductStructuredDescription

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

Kolom
digital_source_type

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

ProductStructuredTitle

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

Kolom
digital_source_type

string

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

string

Teks judul Panjang maksimum adalah 150 karakter

ProductWeight

Berat produk.

Kolom
value

double

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.

Kolom
price

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.
location_id

int64

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

string

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

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.
min_handling_time

int64

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].
max_handling_time

int64

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].
min_transit_time

int64

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].
max_transit_time

int64

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.

ShippingDimension

Dimensi Pengiriman produk.

Kolom
value

double

Dimensi produk yang digunakan untuk menghitung biaya pengiriman item.
unit

string

Satuan nilai.

ShippingWeight

Berat Pengiriman produk.

Kolom
value

double

Berat produk yang digunakan untuk menghitung biaya pengiriman item.
unit

string

Satuan nilai.

SubscriptionCost

Biaya Langganan produk.

Kolom
period

SubscriptionPeriod

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

int64

Jumlah periode langganan yang harus dibayar pembeli.
amount

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.

Pajak

Pajak produk.

Kolom
rate

double

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.
tax_ship

bool

Tetapkan ke true jika pajak dikenakan pada pengiriman.
location_id

int64

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

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*.

UnitPricingBaseMeasure

UnitPricingBaseMeasurement produk.

Kolom
value

int64

Penyebut dari harga unit.
unit

string

Satuan penyebut.

UnitPricingMeasure

UnitPricingMengukur produk.

Kolom
value

double

Ukuran item.
unit

string

Satuan ukuran.