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 menyisipkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

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 mengganti entri tersebut.

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

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 menyisipkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk akhir yang diperbarui dapat diambil.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

Atribut

Atribut.

Kolom
expiration_date

Timestamp

Tanggal habis masa berlaku item, 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 terlalu jauh di masa mendatang.

disclosure_date

Timestamp

Tanggal dan waktu saat penawaran dapat dilihat 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 produk praorder tersedia untuk dikirim, dalam format ISO 8601.

gtin[]

string

Nomor Barang Perdagangan Global (GTIN) dari item tersebut. Anda dapat memberikan hingga 10 GTIN.

price

Price

Harga item.

installment

Installment

Jumlah dan jumlah cicilan yang harus dibayar untuk 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 dalam 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 satuan yang diberikan. Nilai harus antara 0 (eksklusif) dan 3000 (inklusif).

product_length

ProductDimension

Durasi produk dalam unit yang disediakan. Nilai harus antara 0 (eksklusif) dan 3000 (inklusif).

product_width

ProductDimension

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

product_weight

ProductWeight

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

shipping[]

Shipping

Aturan pengiriman.

free_shipping_threshold[]

FreeShippingThreshold

Kondisi yang harus dipenuhi agar produk memiliki 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 untuk pengiriman.

size_types[]

string

Potongan item. Jenis ini dapat digunakan untuk merepresentasikan jenis ukuran gabungan untuk item pakaian. Anda dapat memberikan maksimal dua jenis ukuran (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 denominator harga satuan.

ads_labels[]

string

Serupa dengan ads_grouping, tetapi hanya berfungsi di 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 sorotan 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 diberikan 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 akan dihapus dari negara yang dikonfigurasi di setelan sumber data.

cloud_export_additional_properties[]

CloudExportAdditionalProperties

Kolom tambahan untuk diekspor ke program Cloud Retail.

certifications[]

Certification

Sertifikasi Produk, misalnya untuk pelabelan efisiensi energi produk yang dicatat dalam database EPREL Uni Eropa. Lihat artikel Pusat Bantuan untuk mengetahui 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), yang memastikan bahwa diskon pada penawaran penjual tidak turun di bawah nilai ini, sehingga mempertahankan nilai dan profitabilitas penawaran.

sustainability_incentives[]

ProductSustainabilityIncentive

Daftar program insentif keberlanjutan.

identifier_exists

bool

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

is_bundle

bool

Apakah item tersebut merupakan paket yang ditentukan penjual. Paket adalah pengelompokan khusus 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

Target kelompok usia 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 dari 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.

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 maksimum (dalam hari kerja).

min_handling_time

int64

Waktu pemrosesan produk minimal (dalam hari kerja).

shipping_label

string

Label paket produk, yang 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 tempat ukuran ditentukan. Direkomendasikan untuk item pakaian.

tax_category

string

Kategori pajak produk.

energy_efficiency_class

string

Tingkat efisiensi energi seperti yang ditentukan dalam direktif Uni Eropa 2010/30/EU.

min_energy_efficiency_class

string

Tingkat efisiensi energi seperti yang ditentukan dalam direktif Uni Eropa 2010/30/EU.

max_energy_efficiency_class

string

Tingkat efisiensi energi seperti yang ditentukan dalam direktif Uni Eropa 2010/30/EU.

multipack

int64

Jumlah produk yang sama dalam multipak yang ditentukan penjual.

ads_grouping

string

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

ads_redirect

string

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

display_ads_id

string

ID untuk item dalam 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 item khusus dalam kampanye Shopping.

custom_label_1

string

Label kustom 1 untuk pengelompokan item khusus dalam kampanye Shopping.

custom_label_2

string

Label kustom 2 untuk pengelompokan item khusus dalam kampanye Shopping.

custom_label_3

string

Label kustom 3 untuk pengelompokan item khusus dalam kampanye Shopping.

custom_label_4

string

Label kustom 4 untuk pengelompokan item khusus 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.

pause

string

Publikasi item ini akan dijeda untuk sementara.

structured_title

ProductStructuredTitle

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

structured_description

ProductStructuredDescription

Deskripsi terstruktur, untuk deskripsi yang dibuat secara algoritme (AI).

Sertifikasi

Sertifikasi produk, yang 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 kelas, level, atau nilai), misalnya "A+", "C", "emas". Panjang maksimum adalah 2.000 karakter.

CloudExportAdditionalProperties

Properti produk untuk Cloud Retail API. Misalnya, properti untuk produk TV dapat berupa "Screen-Resolution" atau "Screen-Size".

Kolom
text_value[]

string

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

int_value[]

int64

Nilai bilangan bulat dari properti yang diberikan. Misalnya, 1080 untuk Resolusi Layar produk TV. Frekuensi pengulangan maksimum nilai ini adalah 400. Nilai disimpan dalam urutan arbitrer, tetapi konsisten.

float_value[]

float

Nilai float dari properti yang diberikan. Misalnya, untuk produk TV 1.2345. Frekuensi pengulangan maksimum nilai ini adalah 400. Nilai disimpan dalam urutan arbitrer, tetapi konsisten.

property_name

string

Nama properti yang diberikan. Misalnya, "Screen-Resolution" untuk produk TV. Ukuran string maksimum adalah 256 karakter.

bool_value

bool

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

min_value

float

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

max_value

float

Nilai float maksimum properti yang diberikan. Misalnya, untuk produk TV 100.00.

unit_code

string

Unit properti yang ditentukan. Misalnya, "Pixels" 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} dengan bagian terakhir product terdiri dari 4 bagian: channel~content_language~feed_label~offer_id contoh untuk nama produk adalah "accounts/123/productInputs/online~en~US~sku123"

data_source

string

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

FreeShippingThreshold

Kondisi yang harus dipenuhi agar produk memiliki pengiriman gratis.

Kolom
country

string

Kode wilayah CLDR 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} dengan bagian terakhir product terdiri dari 4 bagian: channel~content_language~feed_label~offer_id contoh untuk nama produk adalah "accounts/123/products/online~en~US~sku123"

InsertProductInputRequest

Pesan permintaan untuk metode InsertProductInput.

Kolom
parent

string

Wajib. Akun tempat produk ini akan disisipkan. 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.

Hanya sumber data API yang didukung.

Format: accounts/{account}/dataSources/{datasource}.

Angsuran

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 yang akan mencantumkan produk yang diproses. Format: accounts/{account}

page_size

int32

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

page_token

string

Token halaman, diterima dari panggilan ListProducts sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListProducts harus sesuai 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 akan ada halaman berikutnya.

LoyaltyPoints

Pesan yang mewakili poin loyalitas.

Kolom
name

string

Nama program poin loyalitas. Sebaiknya batasi nama 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 instan. 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 saat pembelian.

member_price_effective_date

Interval

Rentang tanggal saat item memenuhi syarat untuk harga pelanggan. Jika tidak ditentukan, harga pelanggan selalu berlaku. Rentang tanggal diwakili oleh sepasang tanggal ISO 8601 yang dipisahkan dengan spasi, koma, atau garis miring.

shipping_label

string

Label manfaat pengiriman. Jika kolom memiliki nilai, penawaran ini memiliki manfaat pengiriman untuk program loyalitas. Jika nilai kolom tidak diberikan, item tidak memenuhi syarat untuk pengiriman loyalitas untuk tingkat loyalitas yang diberikan.

Produk

Produk yang diproses, dibuat dari beberapa product inputs setelah menerapkan aturan dan sumber data tambahan. Produk yang diproses ini cocok dengan yang ditampilkan di akun Merchant Center Anda serta di iklan Shopping dan platform Google lainnya. Setiap produk dibuat dari tepat satu input produk sumber data utama, dan beberapa input sumber data tambahan. Setelah menyisipkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dan diperbarui dapat diambil.

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

Kolom
name

string

Nama produk. Format: "{product.name=accounts/{account}/products/{product}}" dengan bagian terakhir product terdiri dari 4 bagian: channel~content_language~feed_label~offer_id contoh untuk nama produk adalah "accounts/123/products/online~en~US~sku123"

channel

ChannelEnum

Hanya output. Saluran produk.

offer_id

string

Hanya output. ID unik Anda untuk produk. Hal ini sama untuk input produk dan produk yang diproses. Spasi kosong di awal dan di akhir akan dihapus dan beberapa spasi kosong akan diganti dengan satu spasi kosong setelah dikirim. Lihat spesifikasi data produk untuk mengetahui detailnya.

content_language

string

Hanya output. Kode bahasa ISO 639-1 dua huruf 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 dalam bentuk generik (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. Merepresentasikan versi produk yang ada (keaktualan), yang dapat digunakan untuk mempertahankan urutan yang tepat saat beberapa pembaruan dilakukan secara bersamaan.

Jika ditetapkan, penyisipan akan dicegah jika nomor versi lebih rendah dari nomor versi saat ini dari produk yang ada. 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 serangkaian detail produk.

attribute_name

string

Nama detail produk.

attribute_value

string

Nilai detail produk.

ProductDimension

Dimensi produk.

Kolom
value

double

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

unit

string

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

ProductInput

Referensi ini mewakili data input yang Anda kirimkan untuk 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 yang diproses.

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

Atribut berikut diperlukan: feedLabel, contentLanguage, dan offerId.

Setelah menyisipkan, 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 atribut yang sesuai dalam spesifikasi vertikal dengan beberapa pengecualian.

Kolom
name

string

ID. Nama input produk. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}" dengan bagian terakhir productinput terdiri dari 4 bagian: channel~content_language~feed_label~offer_id contoh untuk nama input produk adalah "accounts/123/productInputs/online~en~US~sku123"

product

string

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

channel

ChannelEnum

Tidak dapat diubah. Saluran produk.

offer_id

string

Wajib. Tidak dapat diubah. ID unik Anda untuk produk. Hal ini sama untuk input produk dan produk yang diproses. Spasi kosong di awal dan di akhir akan dihapus dan beberapa spasi kosong akan diganti dengan satu spasi kosong setelah dikirim. Lihat spesifikasi data produk untuk mengetahui detailnya.

content_language

string

Wajib. Tidak dapat diubah. Kode bahasa ISO 639-1 dua huruf 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 dalam bentuk generik (misalnya, { "name": "size type", "value": "regular" }). Hal ini berguna untuk mengirimkan atribut yang tidak ditampilkan secara eksplisit oleh API, seperti atribut tambahan yang digunakan untuk Beli dengan Google. Jumlah karakter maksimum yang diizinkan untuk setiap atribut kustom adalah 10240 (mewakili jumlah karakter untuk nama dan nilai). Maksimal 2.500 atribut kustom dapat ditetapkan per produk, dengan ukuran total 102,4 KB. Garis bawah dalam nama atribut kustom akan diganti dengan spasi saat disisipkan.

version_number

int64

Opsional. Merepresentasikan versi produk yang ada (keaktualan), yang dapat digunakan untuk mempertahankan urutan yang tepat saat beberapa pembaruan dilakukan secara bersamaan.

Jika ditetapkan, penyisipan akan dicegah jika nomor versi lebih rendah dari nomor versi saat ini dari produk yang ada. 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 dimaksudkan 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 berakhirnya masa berlaku item, dalam format ISO 8601.

DestinationStatus

Status tujuan 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 dari 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 masalahnya disebabkan oleh satu atribut.

reporting_context

ReportingContextEnum

Konteks pelaporan 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.

applicable_countries[]

string

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

Keparahan

Pengaruh masalah terhadap penayangan produk.

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

ProductStructuredDescription

Deskripsi terstruktur, untuk deskripsi yang dibuat secara algoritme (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 secara 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 judul adalah 150 karakter

ProductSustainabilityIncentive

Informasi terkait program insentif terkait keberlanjutan seperti diskon atau keringanan pajak.

Kolom
Kolom union value. Nilai insentif keberlanjutan. value hanya dapat berupa salah satu dari berikut:
amount

Price

Jumlah tetap insentif.

percentage

double

Persentase harga promo yang menjadi dasar penerapan insentif.

type

Type

Program insentif keberlanjutan.

Jenis

Jenis program insentif keberlanjutan yang didukung.

Enum
TYPE_UNSPECIFIED Jenis insentif keberlanjutan yang tidak ditentukan atau tidak diketahui.
EV_TAX_CREDIT Program yang menawarkan pengurangan kewajiban pajak untuk kendaraan listrik dan, di beberapa negara, kendaraan hybrid plugin. Pengurangan ini dapat didasarkan pada jumlah tertentu atau persentase dari harga jual.
EV_PRICE_DISCOUNT Program subsidi, yang sering disebut bonus lingkungan, memberikan hibah pembelian untuk kendaraan listrik dan, di beberapa negara, kendaraan hibrida plug-in. Jumlah hibah dapat berupa jumlah tetap atau persentase dari harga jual.

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. Satuan berat. Nilai yang dapat diterima adalah: * "g" * "kg" * "oz" * "lb"

Pengiriman

Pengiriman produk.

Kolom
price

Price

Harga pengiriman tetap, direpresentasikan sebagai angka.

country

string

Kode wilayah CLDR negara tujuan pengiriman item.

region

string

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

service

string

Deskripsi dalam format bebas untuk kelas layanan atau kecepatan pengiriman.

location_id

int64

ID numerik lokasi yang menjadi tempat berlakunya tarif pengiriman seperti yang ditentukan di AdWords API.

location_group_name

string

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

postal_code

string

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

min_handling_time

int64

Waktu pemrosesan minimum (inklusif) antara saat pesanan diterima dan dikirim dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan hari diterima jika pesanan tersebut diterima sebelum batas waktu. minHandlingTime hanya dapat ada bersama dengan maxHandlingTime; tetapi tidak diperlukan jika maxHandlingTime ada.

max_handling_time

int64

Waktu pemrosesan maksimum (inklusif) antara saat pesanan diterima dan dikirim dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan hari diterima jika pesanan tersebut diterima sebelum batas waktu. maxHandlingTime dan maxTransitTime diperlukan jika memberikan kecepatan pengiriman. minHandlingTime bersifat opsional jika maxHandlingTime ada.

min_transit_time

int64

Waktu transit minimum (inklusif) antara saat pesanan dikirim dan saat pesanan diterima dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan hari pengiriman. minTransitTime hanya dapat ada bersama dengan maxTransitTime; tetapi tidak diperlukan jika maxTransitTime ada.

max_transit_time

int64

Waktu transit maksimum (inklusif) antara saat pesanan dikirim dan saat pesanan diterima dalam hari kerja. 0 berarti pesanan dikirim pada hari yang sama dengan hari pengiriman. maxHandlingTime dan maxTransitTime diperlukan jika memberikan kecepatan pengiriman. minTransitTime bersifat opsional jika maxTransitTime ada.

ShippingDimension

ShippingDimension produk.

Kolom
value

double

Dimensi produk yang digunakan untuk menghitung biaya pengiriman item.

unit

string

Satuan nilai.

ShippingWeight

ShippingWeight produk.

Kolom
value

double

Berat produk yang digunakan untuk menghitung biaya pengiriman item.

unit

string

Satuan nilai.

SubscriptionCost

SubscriptionCost 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 dikenai 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 yang dikenai tarif pajak seperti yang ditentukan di AdWords API.

postal_code

string

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

UnitPricingBaseMeasure

UnitPricingBaseMeasure produk.

Kolom
value

int64

Pembilang harga satuan.

unit

string

Satuan denominator.

UnitPricingMeasure

UnitPricingMeasure produk.

Kolom
value

double

Pengukuran item.

unit

string

Satuan pengukuran.