Package google.shopping.merchant.reports.v1beta

Indeks

• ReportService (antar muka)
• BestSellersBrandView (pesan)
• BestSellersProductClusterView (pesan)
• BestSellersProductClusterView.InventoryStatus (enum)
• CompetitiveVisibilityBenchmarkView (pesan)
• CompetitiveVisibilityCompetitorView (pesan)
• CompetitiveVisibilityTopMerchantView (pesan)
• MarketingMethod (pesan)
• MarketingMethod.MarketingMethodEnum (enum)
• NonProductPerformanceView (pesan)
• PriceCompetitivenessProductView (pesan)
• PriceInsightsProductView (pesan)
• PriceInsightsProductView.Effectiveness (enum)
• ProductPerformanceView (pesan)
• ProductView (pesan)
• ProductView.AggregatedReportingContextStatus (enum)
• ProductView.ClickPotential (enum)
• ProductView.ItemIssue (pesan)
• ProductView.ItemIssue.ItemIssueResolution (enum)
• ProductView.ItemIssue.ItemIssueSeverity (pesan)
• ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (enum)
• ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (pesan)
• ProductView.ItemIssue.ItemIssueType (pesan)
• RelativeDemand (pesan)
• RelativeDemand.RelativeDemandEnum (enum)
• RelativeDemandChangeType (pesan)
• RelativeDemandChangeType.RelativeDemandChangeTypeEnum (enum)
• ReportGranularity (pesan)
• ReportGranularity.ReportGranularityEnum (enum)
• ReportRow (pesan)
• SearchRequest (pesan)
• SearchResponse (pesan)
• TrafficSource (pesan)
• TrafficSource.TrafficSourceEnum (enum)

ReportService

Layanan untuk mengambil laporan dan insight tentang produk Anda, performanya, dan lingkungan kompetitifnya di Google.

Telusuri

rpc Search(SearchRequest) returns (SearchResponse) Mengambil laporan yang ditentukan oleh kueri penelusuran. Respons mungkin berisi baris yang lebih sedikit dari yang ditentukan oleh page_size. Andalkan next_page_token untuk menentukan apakah ada lebih banyak baris yang harus diminta. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BestSellersBrandView

Kolom tersedia untuk kueri di tabel best_sellers_brand_view.

Laporan Item terlaris dengan merek teratas.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
report_date	Date Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari yang berikut: Hari pertama dalam seminggu (Senin) untuk laporan mingguan, Hari pertama setiap bulan untuk laporan bulanan. Wajib dalam klausa SELECT. Jika kondisi WHERE pada report_date tidak ditentukan dalam kueri, laporan mingguan atau bulanan terbaru yang tersedia akan ditampilkan.
report_granularity	ReportGranularityEnum Perincian laporan. Peringkat dapat dilakukan selama satu minggu atau jangka waktu satu bulan. Wajib dalam klausa SELECT. Kondisi pada report_granularity diperlukan dalam klausa WHERE.
report_country_code	string Negara tempat peringkat dihitung. Direpresentasikan dalam format ISO 3166. Wajib dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id	int64 ID kategori produk Google untuk menghitung peringkat, yang diwakili dalam taksonomi produk Google. Wajib dalam klausa SELECT. Jika kondisi WHERE di report_category_id tidak ditentukan dalam kueri, peringkat untuk semua kategori tingkat atas akan ditampilkan.
brand	string Nama merek.
rank	int64 Popularitas merek di Google Ads dan platform organik, dalam kategori dan negara yang dipilih, berdasarkan estimasi jumlah unit yang terjual.
previous_rank	int64 Peringkat popularitas pada minggu atau bulan sebelumnya.
relative_demand	RelativeDemandEnum Estimasi permintaan dalam kaitannya dengan merek terpopuler dalam kategori dan negara yang sama.
previous_relative_demand	RelativeDemandEnum Estimasi permintaan dalam kaitannya dengan merek terpopuler dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.
relative_demand_change	RelativeDemandChangeTypeEnum Perubahan pada estimasi permintaan. Apakah itu naik, tenggelam, atau tetap datar.

BestSellersProductClusterView

Kolom tersedia untuk kueri di tabel best_sellers_product_cluster_view.

Laporan Item terlaris dengan cluster produk teratas. Cluster produk adalah pengelompokan untuk berbagai penawaran dan varian yang mewakili produk yang sama, misalnya, Google Pixel 7.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
report_date	Date Tanggal laporan. Nilai kolom ini hanya dapat berupa salah satu dari yang berikut: Hari pertama dalam seminggu (Senin) untuk laporan mingguan, Hari pertama setiap bulan untuk laporan bulanan. Wajib dalam klausa SELECT. Jika kondisi WHERE pada report_date tidak ditentukan dalam kueri, laporan mingguan atau bulanan terbaru yang tersedia akan ditampilkan.
variant_gtins[]	string GTIN contoh varian cluster produk.
report_granularity	ReportGranularityEnum Perincian laporan. Peringkat dapat dilakukan selama satu minggu atau jangka waktu satu bulan. Wajib dalam klausa SELECT. Kondisi pada report_granularity diperlukan dalam klausa WHERE.
report_country_code	string Negara tempat peringkat dihitung. Direpresentasikan dalam format ISO 3166. Wajib dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id	int64 ID kategori produk Google untuk menghitung peringkat, yang diwakili dalam taksonomi produk Google. Wajib dalam klausa SELECT. Jika kondisi WHERE di report_category_id tidak ditentukan dalam kueri, peringkat untuk semua kategori tingkat atas akan ditampilkan.
title	string Judul cluster produk.
brand	string Merek cluster produk.
category_l1	string Kategori produk (tingkat 1) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.
category_l2	string Kategori produk (tingkat 2) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.
category_l3	string Kategori produk (tingkat 3) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.
category_l4	string Kategori produk (tingkat 4) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.
category_l5	string Kategori produk (tingkat 5) dari cluster produk, yang direpresentasikan dalam taksonomi produk Google.
inventory_status	InventoryStatus Apakah cluster produk memiliki IN_STOCK dalam sumber data produk Anda setidaknya di salah satu negara, OUT_OF_STOCK di sumber data produk Anda di semua negara, atau NOT_IN_INVENTORY sama sekali. Kolom ini tidak mempertimbangkan filter negara laporan Terlaris.
brand_inventory_status	InventoryStatus Jika setidaknya ada satu produk dari merek tersebut yang saat ini IN_STOCK di sumber data produk Anda di minimal salah satu negara, semua produk OUT_OF_STOCK di sumber data produk Anda di semua negara, atau NOT_IN_INVENTORY. Kolom ini tidak mempertimbangkan filter negara laporan Terlaris.
rank	int64 Popularitas cluster produk di Google Ads dan platform organik, dalam kategori dan negara yang dipilih, berdasarkan estimasi jumlah unit yang terjual.
previous_rank	int64 Peringkat popularitas pada minggu atau bulan sebelumnya.
relative_demand	RelativeDemandEnum Estimasi permintaan dalam kaitannya dengan cluster produk berperingkat popularitas tertinggi dalam kategori dan negara yang sama.
previous_relative_demand	RelativeDemandEnum Estimasi permintaan dalam kaitannya dengan cluster produk berperingkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.
relative_demand_change	RelativeDemandChangeTypeEnum Perubahan pada estimasi permintaan. Apakah itu naik, tenggelam, atau tetap datar.

InventoryStatus

Status cluster atau merek produk di inventaris Anda.

Enum
INVENTORY_STATUS_UNSPECIFIED	Tidak ditentukan.
IN_STOCK	Anda memiliki stok produk untuk cluster atau merek produk ini.
OUT_OF_STOCK	Anda memiliki produk untuk cluster atau merek produk ini dalam inventaris, tetapi stok saat ini sedang habis.
NOT_IN_INVENTORY	Anda tidak memiliki produk untuk cluster produk atau merek ini dalam inventaris.

CompetitiveVisibilityBenchmarkView

Kolom tersedia untuk kueri di tabel competitive_visibility_benchmark_view.

Laporan Visibilitas kompetitif dengan tolok ukur kategori.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
date	Date Tanggal baris ini. Wajib dalam klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.
report_country_code	string Negara tempat tayangan muncul. Wajib dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id	int64 ID kategori produk Google yang akan dihitung laporannya, yang ditampilkan dalam taksonomi produk Google. Wajib dalam klausa SELECT. Kondisi pada report_category_id diperlukan dalam klausa WHERE.
traffic_source	TrafficSourceEnum Sumber traffic tayangan. Wajib dalam klausa SELECT.
your_domain_visibility_trend	double Perubahan visibilitas berdasarkan tayangan untuk domain Anda sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan bukan nol). Tidak bisa difilter pada klausa 'WHERE'.
category_benchmark_visibility_trend	double Perubahan visibilitas berdasarkan tayangan sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan bukan nol) untuk kumpulan penjual gabungan dengan visibilitas tertinggi yang mendekati pasar. Tidak bisa difilter pada klausa 'WHERE'.

CompetitiveVisibilityCompetitorView

Kolom tersedia untuk kueri di tabel competitive_visibility_competitor_view.

Laporan Visibilitas kompetitif dengan bisnis yang memiliki visibilitas serupa.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
date	Date Tanggal baris ini. Kondisi pada date diperlukan dalam klausa WHERE.
domain	string Domain pesaing atau domain Anda, jika 'is_your_domain' benar. Wajib dalam klausa SELECT. Tidak bisa difilter pada klausa 'WHERE'.
is_your_domain	bool Benar jika baris ini berisi data untuk domain Anda. Tidak bisa difilter pada klausa 'WHERE'.
report_country_code	string Negara tempat tayangan muncul. Wajib dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id	int64 ID kategori produk Google yang akan dihitung laporannya, yang ditampilkan dalam taksonomi produk Google. Wajib dalam klausa SELECT. Kondisi pada report_category_id diperlukan dalam klausa WHERE.
traffic_source	TrafficSourceEnum Sumber traffic tayangan. Wajib dalam klausa SELECT.
rank	int64 Posisi domain di peringkat bisnis serupa untuk kunci yang dipilih (date, report_category_id, report_country_code, traffic_source) berdasarkan tayangan. 1 adalah yang tertinggi. Tidak bisa difilter pada klausa 'WHERE'.
ads_organic_ratio	double Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka tersebut dibulatkan dan dikelompokkan. Tidak bisa difilter pada klausa 'WHERE'.
page_overlap_rate	double Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer yang bersaing ditampilkan bersama penawaran Anda di halaman yang sama. Tidak bisa difilter pada klausa 'WHERE'.
higher_position_rate	double Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman dibandingkan dengan penawaran Anda. Tidak bisa difilter pada klausa 'WHERE'.
relative_visibility	double Visibilitas relatif menunjukkan seberapa sering penawaran pesaing Anda ditampilkan dibandingkan dengan penawaran Anda. Dengan kata lain, ini adalah jumlah tayangan yang ditampilkan dari retailer pesaing dibagi dengan jumlah tayangan iklan Anda yang ditampilkan selama rentang waktu yang dipilih untuk kategori produk dan negara yang dipilih. Tidak bisa difilter pada klausa 'WHERE'.

CompetitiveVisibilityTopMerchantView

Kolom tersedia untuk kueri di tabel competitive_visibility_top_merchant_view.

Laporan visibilitas kompetitif dengan bisnis yang memiliki visibilitas tertinggi.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
date	Date Tanggal baris ini. Tidak dapat dipilih dalam klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.
domain	string Domain pesaing atau domain Anda, jika 'is_your_domain' benar. Wajib dalam klausa SELECT. Tidak bisa difilter pada klausa 'WHERE'.
is_your_domain	bool Benar jika baris ini berisi data untuk domain Anda. Tidak bisa difilter pada klausa 'WHERE'.
report_country_code	string Negara tempat tayangan muncul. Wajib dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id	int64 ID kategori produk Google yang akan dihitung laporannya, yang ditampilkan dalam taksonomi produk Google. Wajib dalam klausa SELECT. Kondisi pada report_category_id diperlukan dalam klausa WHERE.
traffic_source	TrafficSourceEnum Sumber traffic tayangan. Wajib dalam klausa SELECT.
rank	int64 Posisi domain di peringkat penjual teratas untuk kunci yang dipilih (date, report_category_id, report_country_code, traffic_source) berdasarkan tayangan. 1 adalah yang tertinggi. Tidak bisa difilter pada klausa 'WHERE'.
ads_organic_ratio	double Rasio iklan / organik menunjukkan seberapa sering domain menerima tayangan dari iklan Shopping dibandingkan dengan traffic organik. Angka tersebut dibulatkan dan dikelompokkan. Tidak bisa difilter pada klausa 'WHERE'.
page_overlap_rate	double Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer yang bersaing ditampilkan bersama penawaran Anda di halaman yang sama. Tidak bisa difilter pada klausa 'WHERE'.
higher_position_rate	double Rasio posisi yang lebih tinggi menunjukkan seberapa sering penawaran pesaing ditempatkan di posisi yang lebih tinggi pada halaman dibandingkan dengan penawaran Anda. Tidak bisa difilter pada klausa 'WHERE'.

MarketingMethod

Jenis ini tidak memiliki kolom.

Metode pemasaran yang digunakan untuk mempromosikan produk Anda di Google (organik vs. iklan).

MarketingMethodEnum

Nilai metode pemasaran.

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED	Tidak ditentukan.
ORGANIC	Pemasaran organik.
ADS	Pemasaran berbasis iklan.

NonProductPerformanceView

Kolom tersedia untuk kueri di tabel non_product_performance_view.

Data performa terkait gambar dan link toko online yang mengarah ke halaman non-produk Anda. Hal ini mencakup metrik performa (misalnya, clicks) dan dimensi yang sesuai dengan metrik performa yang disegmentasikan (misalnya, date).

Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih minimal satu kolom metrik.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
date	Date Tanggal di zona waktu penjual tempat metrik diterapkan. Segmen. Kondisi pada date diperlukan dalam klausa WHERE.
week	Date Hari pertama dalam seminggu (Senin) dari tanggal metrik di zona waktu penjual. Segmen.
clicks	int64 Jumlah klik pada gambar dan link toko online yang mengarah ke halaman non-produk Anda. Metrik.
impressions	int64 Frekuensi gambar dan link toko online yang mengarah ke halaman non-produk Anda ditampilkan. Metrik.
click_through_rate	double Rasio klik-tayang - jumlah klik (clicks) dibagi dengan jumlah tayangan (impressions) gambar dan link toko online yang mengarah ke halaman non-produk Anda. Metrik.

PriceCompetitivenessProductView

Kolom tersedia untuk kueri di tabel price_competitiveness_product_view.

Laporan daya saing harga.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
price	Price Harga produk saat ini.
benchmark_price	Price Tolok ukur harga terbaru yang tersedia untuk katalog produk di negara tolok ukur.
report_country_code	string Negara harga patokan. Direpresentasikan dalam format ISO 3166. Wajib dalam klausa SELECT.
id	string ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Dapat digunakan untuk menggabungkan data dengan tabel product_view. Wajib dalam klausa SELECT.
offer_id	string ID produk yang diberikan penjual.
title	string Judul produk.
brand	string Merek produk.
category_l1	string Kategori produk (tingkat 1) di taksonomi produk Google.
category_l2	string Kategori produk (tingkat 2) di taksonomi produk Google.
category_l3	string Kategori produk (tingkat 3) di taksonomi produk Google.
category_l4	string Kategori produk (tingkat 4) di taksonomi produk Google.
category_l5	string Kategori produk (tingkat 5) di taksonomi produk Google.
product_type_l1	string Jenis produk (tingkat 1) di taksonomi produk milik penjual.
product_type_l2	string Jenis produk (tingkat 2) di taksonomi produk milik penjual.
product_type_l3	string Jenis produk (tingkat 3) di taksonomi produk milik penjual.
product_type_l4	string Jenis produk (tingkat 4) di taksonomi produk milik penjual.
product_type_l5	string Jenis produk (tingkat 5) di taksonomi produk milik penjual.

PriceInsightsProductView

Kolom tersedia untuk kueri di tabel price_insights_product_view.

Analisis harga.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
price	Price Harga produk saat ini.
suggested_price	Price Harga terbaru yang disarankan untuk produk.
effectiveness	Effectiveness Prediksi efektivitas penerapan saran harga, dikelompokkan.
id	string ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Dapat digunakan untuk menggabungkan data dengan tabel product_view. Wajib dalam klausa SELECT.
offer_id	string ID produk yang diberikan penjual.
title	string Judul produk.
brand	string Merek produk.
category_l1	string Kategori produk (tingkat 1) di taksonomi produk Google.
category_l2	string Kategori produk (tingkat 2) di taksonomi produk Google.
category_l3	string Kategori produk (tingkat 3) di taksonomi produk Google.
category_l4	string Kategori produk (tingkat 4) di taksonomi produk Google.
category_l5	string Kategori produk (tingkat 5) di taksonomi produk Google.
product_type_l1	string Jenis produk (tingkat 1) di taksonomi produk milik penjual.
product_type_l2	string Jenis produk (tingkat 2) di taksonomi produk milik penjual.
product_type_l3	string Jenis produk (tingkat 3) di taksonomi produk milik penjual.
product_type_l4	string Jenis produk (tingkat 4) di taksonomi produk milik penjual.
product_type_l5	string Jenis produk (tingkat 5) di taksonomi produk milik penjual.
predicted_impressions_change_fraction	double Prediksi perubahan tayangan dalam bentuk pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan tayangan sebesar 5%.
predicted_clicks_change_fraction	double Prediksi perubahan klik sebagai pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan klik sebesar 5%.
predicted_conversions_change_fraction	double Prediksi perubahan konversi dalam bentuk pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan konversi sebesar 5%).

Efektivitas

Bucket efektivitas diprediksi.

Efektivitas menunjukkan produk mana yang paling diuntungkan dari perubahan harga. Rating ini mempertimbangkan peningkatan performa yang diprediksi dengan menyesuaikan harga promo dan selisih antara harga saat ini dan harga yang disarankan. Saran harga dengan efektivitas HIGH diprediksi akan mendorong peningkatan performa terbesar.

Enum
EFFECTIVENESS_UNSPECIFIED	Efektivitas tidak diketahui.
LOW	Efektivitasnya rendah.
MEDIUM	Efektivitasnya sedang.
HIGH	Tingkat efektivitasnya tinggi.

ProductPerformanceView

Kolom tersedia untuk kueri di tabel product_performance_view.

Data performa produk untuk akun Anda, termasuk metrik performa (misalnya, clicks) dan dimensi yang sesuai dengan metrik performa yang disegmentasikan (misalnya, offer_id). Nilai dimensi produk, seperti offer_id, mencerminkan status produk pada saat tayangan iklan.

Kolom segmen tidak dapat dipilih dalam kueri tanpa memilih minimal satu kolom metrik.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
date	Date Tanggal di zona waktu penjual tempat metrik diterapkan. Segmen. Kondisi pada date diperlukan dalam klausa WHERE.
week	Date Hari pertama dalam seminggu (Senin) dari tanggal metrik di zona waktu penjual. Segmen.
conversion_value	Price Nilai konversi yang diatribusikan ke produk, dilaporkan pada tanggal konversi. Metrik. Hanya tersedia untuk sumber traffic FREE.
marketing_method	MarketingMethodEnum Metode pemasaran yang menerapkan metrik. Segmen.
customer_country_code	string Kode negara tempat pelanggan berada pada saat peristiwa. Direpresentasikan dalam format ISO 3166. Segmen. Jika negara pelanggan tidak dapat ditentukan, kode 'ZZ' khusus akan dikembalikan.
offer_id	string ID produk yang diberikan penjual. Segmen.
title	string Judul produk. Segmen.
brand	string Merek produk. Segmen.
category_l1	string Kategori produk (tingkat 1) dalam taksonomi produk Google. Segmen.
category_l2	string Kategori produk (tingkat 2) dalam taksonomi produk Google. Segmen.
category_l3	string Kategori produk (tingkat 3) dalam taksonomi produk Google. Segmen.
category_l4	string Kategori produk (tingkat 4) dalam taksonomi produk Google. Segmen.
category_l5	string Kategori produk (tingkat 5) dalam taksonomi produk Google. Segmen.
product_type_l1	string Tipe produk (tingkat 1) di taksonomi produk penjual sendiri. Segmen.
product_type_l2	string Tipe produk (tingkat 2) di taksonomi produk penjual sendiri. Segmen.
product_type_l3	string Tipe produk (tingkat 3) di taksonomi produk penjual sendiri. Segmen.
product_type_l4	string Tipe produk (tingkat 4) di taksonomi produk penjual sendiri. Segmen.
product_type_l5	string Tipe produk (tingkat 5) di taksonomi produk penjual. Segmen.
custom_label0	string Label kustom 0 untuk pengelompokan produk khusus. Segmen.
custom_label1	string Label kustom 1 untuk pengelompokan produk khusus. Segmen.
custom_label2	string Label kustom 2 untuk pengelompokan produk khusus. Segmen.
custom_label3	string Label kustom 3 untuk pengelompokan produk khusus. Segmen.
custom_label4	string Label kustom 4 untuk pengelompokan produk khusus. Segmen.
clicks	int64 Jumlah klik. Metrik.
impressions	int64 Frekuensi produk penjual ditampilkan. Metrik.
click_through_rate	double Rasio klik-tayang - jumlah klik yang diterima produk penjual (klik) dibagi dengan frekuensi produk ditampilkan (tayangan). Metrik.
conversions	double Jumlah konversi yang diatribusikan ke produk, dilaporkan pada tanggal konversi. Bergantung pada model atribusi, konversi dapat didistribusikan ke beberapa klik, dengan kredit yang ditetapkan untuk setiap klik. Metrik ini adalah jumlah dari semua kredit tersebut. Metrik. Hanya tersedia untuk sumber traffic FREE.
conversion_rate	double Jumlah konversi dibagi dengan jumlah klik, yang dilaporkan pada tanggal tayangan. Metrik. Hanya tersedia untuk sumber traffic FREE.

ProductView

Kolom tersedia untuk kueri di tabel product_view.

Produk dalam inventaris saat ini. Produk dalam tabel ini sama seperti di sub-API Produk, tetapi tidak semua atribut produk dari sub-API Produk tersedia untuk kueri dalam tabel ini. Berbeda dengan sub-API Produk, tabel ini memungkinkan untuk memfilter daftar produk yang ditampilkan berdasarkan atribut produk. Untuk mengambil satu produk paling lambat id atau mencantumkan semua produk, sub-API Produk harus digunakan.

Nilai hanya ditetapkan untuk kolom yang diminta secara eksplisit dalam kueri penelusuran permintaan.

Kolom
price	Price Harga produk. Tidak ada jika informasi tentang harga produk tidak tersedia.
gtin[]	string Daftar Nomor Barang Perdagangan Global (GTIN) produk.
creation_time	Timestamp Waktu penjual membuat produk dalam detik stempel waktu.
expiration_date	Date Tanggal habis masa berlaku produk, yang ditentukan saat penyisipan.
item_issues[]	ItemIssue Daftar masalah item untuk produk. Kolom ini tidak dapat digunakan untuk mengurutkan hasil. Hanya atribut kolom yang dipilih (misalnya, item_issues.severity.aggregated_severity) yang dapat digunakan untuk memfilter hasil.
click_potential	ClickPotential Estimasi potensi performa dibandingkan dengan produk penjual yang memiliki performa tertinggi.
id	string ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Metode API Penjual yang beroperasi pada produk menggunakan parameter ini sebagai parameter name. Wajib dalam klausa SELECT.
channel	ChannelEnum Saluran produk. Dapat berupa ONLINE atau LOCAL.
language_code	string Kode bahasa produk dalam format BCP 47.
feed_label	string Label feed produk.
offer_id	string ID produk yang diberikan penjual.
title	string Judul produk.
brand	string Merek produk.
category_l1	string Kategori produk (tingkat 1) di taksonomi produk Google.
category_l2	string Kategori produk (tingkat 2) di taksonomi produk Google.
category_l3	string Kategori produk (tingkat 3) di taksonomi produk Google.
category_l4	string Kategori produk (tingkat 4) di taksonomi produk Google.
category_l5	string Kategori produk (tingkat 5) di taksonomi produk Google.
product_type_l1	string Jenis produk (tingkat 1) di taksonomi produk milik penjual.
product_type_l2	string Jenis produk (tingkat 2) di taksonomi produk milik penjual.
product_type_l3	string Jenis produk (tingkat 3) di taksonomi produk milik penjual.
product_type_l4	string Jenis produk (tingkat 4) di taksonomi produk milik penjual.
product_type_l5	string Jenis produk (tingkat 5) di taksonomi produk milik penjual.
condition	string Kondisi produk.
availability	string Ketersediaan produk.
shipping_label	string Label paket yang dinormalkan yang ditentukan dalam sumber data.
item_group_id	string ID kelompok item yang disediakan penjual untuk mengelompokkan varian.
thumbnail_link	string Link ke gambar produk yang diproses, yang dihosting di infrastruktur Google.
aggregated_reporting_context_status	AggregatedReportingContextStatus Status gabungan.
click_potential_rank	int64 Peringkat produk berdasarkan potensi kliknya. Produk dengan click_potential_rank 1 memiliki potensi klik tertinggi di antara produk penjual yang memenuhi kondisi kueri penelusuran.

AggregatedReportingContextStatus

Status produk yang digabungkan untuk semua konteks pelaporan.

Berikut adalah contoh cara penghitungan status gabungan:

Listingan gratis	Iklan Shopping	Status
Approved	Approved	VALID
Approved	Tertunda	VALID
Approved	Tidak Disetujui	ELIGIBLE_LIMITED
Tertunda	Tertunda	TERTUNDA
Tidak Disetujui	Tidak Disetujui	NOT_ELIGIBLE_OR_DISAPPROVED

Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED	Tidak ditentukan.
NOT_ELIGIBLE_OR_DISAPPROVED	Produk tidak memenuhi syarat atau tidak disetujui untuk semua konteks pelaporan.
PENDING	Status produk tertunda di semua konteks pelaporan.
ELIGIBLE_LIMITED	Produk memenuhi syarat untuk sebagian (tetapi tidak semua) konteks pelaporan.
ELIGIBLE	Produk memenuhi syarat untuk semua konteks pelaporan.

ClickPotential

Potensi klik produk memperkirakan potensi performanya dibandingkan dengan produk penjual dengan performa tertinggi. Potensi klik suatu produk membantu penjual memprioritaskan produk mana yang harus diperbaiki dan membantu mereka memahami bagaimana performa produk terhadap potensi mereka.

Enum
CLICK_POTENTIAL_UNSPECIFIED	Prediksi dampak klik yang tidak diketahui.
LOW	Berpotensi menerima jumlah klik yang rendah dibandingkan dengan produk penjual yang memiliki performa tertinggi.
MEDIUM	Berpotensi menerima jumlah klik yang sedang dibandingkan dengan produk penjual dengan performa tertinggi.
HIGH	Berpotensi menerima jumlah klik yang serupa dengan produk penjual dengan performa tertinggi.

ItemIssue

Masalah item yang terkait dengan produk.

Kolom
type	ItemIssueType Jenis masalah item.
severity	ItemIssueSeverity Tingkat keparahan masalah item.
resolution	ItemIssueResolution Penyelesaian masalah item.

ItemIssueResolution

Cara menyelesaikan masalah.

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED	Tidak ditentukan.
MERCHANT_ACTION	Penjual harus memperbaiki masalah tersebut.
PENDING_PROCESSING	Masalah ini akan diselesaikan secara otomatis (misalnya, crawl gambar) atau melalui peninjauan Google. Penjual tidak perlu melakukan tindakan apa pun untuk saat ini. Penyelesaian dapat menyebabkan masalah lain (misalnya, jika crawl gagal).

ItemIssueSeverity

Pengaruh masalah tersebut terhadap penayangan produk.

Kolom
severity_per_reporting_context[]	IssueSeverityPerReportingContext Tingkat keparahan masalah sesuai konteks pelaporan.
aggregated_severity	AggregatedIssueSeverity Tingkat keparahan gabungan masalah untuk semua konteks pelaporan yang terpengaruh. Kolom ini dapat digunakan untuk memfilter hasil.

AggregatedIssueSeverity

Tingkat keparahan masalah digabungkan untuk semua konteks pelaporan.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED	Tidak ditentukan.
DISAPPROVED	Masalah menolak produk dalam setidaknya satu konteks pelaporan.
DEMOTED	Masalah mendemosikan produk dalam semua konteks pelaporan yang terpengaruh.
PENDING	Penyelesaian masalah adalah PENDING_PROCESSING.

IssueSeverityPerReportingContext

Tingkat keparahan masalah sesuai konteks pelaporan.

Kolom
disapproved_countries[]	string Daftar negara yang tidak disetujui dalam konteks pelaporan, yang ditampilkan dalam format ISO 3166.
demoted_countries[]	string Daftar negara yang didemosikan dalam konteks pelaporan, ditampilkan dalam format ISO 3166.
reporting_context	ReportingContextEnum Konteks pelaporan masalah berlaku.

ItemIssueType

Jenis masalah.

Kolom
code	string Kode error masalah, setara dengan code Masalah produk.
canonical_attribute	string Nama atribut kanonis untuk masalah khusus atribut.

RelativeDemand

Jenis ini tidak memiliki kolom.

Permintaan relatif dari cluster produk atau merek dalam laporan Terlaris.

RelativeDemandEnum

Nilai permintaan relatif.

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED	Tidak ditentukan.
VERY_LOW	Permintaan adalah 0-5% dari permintaan cluster produk atau merek peringkat tertinggi.
LOW	Permintaan adalah 6-10% dari permintaan cluster produk atau merek peringkat tertinggi.
MEDIUM	Permintaan adalah 11-20% dari permintaan cluster produk atau merek peringkat tertinggi.
HIGH	Permintaan adalah 21-50% dari permintaan cluster produk atau merek berperingkat tertinggi.
VERY_HIGH	Permintaan adalah 51-100% dari permintaan cluster produk atau merek peringkat tertinggi.

RelativeDemandChangeType

Jenis ini tidak memiliki kolom.

Permintaan relatif dari cluster produk atau merek di laporan Item Terlaris dibandingkan dengan jangka waktu sebelumnya.

RelativeDemandChangeTypeEnum

Nilai jenis perubahan permintaan relatif.

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED	Tidak ditentukan.
SINKER	Permintaan relatif lebih rendah dibandingkan jangka waktu sebelumnya.
FLAT	Permintaan relatif sama dengan jangka waktu sebelumnya.
RISER	Permintaan relatif lebih tinggi dibandingkan jangka waktu sebelumnya.

ReportGranularity

Jenis ini tidak memiliki kolom.

Perincian laporan Item terlaris. Laporan terlaris dihitung selama jangka waktu seminggu dan bulan.

ReportGranularityEnum

Laporkan nilai perincian.

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED	Tidak ditentukan.
WEEKLY	Laporan dihitung selama jangka waktu seminggu.
MONTHLY	Laporan dihitung selama jangka waktu satu bulan.

ReportRow

Baris hasil yang ditampilkan dari kueri penelusuran.

Hanya pesan yang sesuai dengan tabel yang dikueri yang diisi dalam respons. Dalam pesan yang terisi, hanya kolom yang diminta secara eksplisit dalam kueri yang akan diisi.

Kolom
product_performance_view	ProductPerformanceView Kolom tersedia untuk kueri di tabel product_performance_view.
non_product_performance_view	NonProductPerformanceView Kolom tersedia untuk kueri di tabel non_product_performance_view.
product_view	ProductView Kolom tersedia untuk kueri di tabel product_view.
price_competitiveness_product_view	PriceCompetitivenessProductView Kolom tersedia untuk kueri di tabel price_competitiveness_product_view.
price_insights_product_view	PriceInsightsProductView Kolom tersedia untuk kueri di tabel price_insights_product_view.
best_sellers_product_cluster_view	BestSellersProductClusterView Kolom tersedia untuk kueri di tabel best_sellers_product_cluster_view.
best_sellers_brand_view	BestSellersBrandView Kolom tersedia untuk kueri di tabel best_sellers_brand_view.
competitive_visibility_competitor_view	CompetitiveVisibilityCompetitorView Kolom tersedia untuk kueri di tabel competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view	CompetitiveVisibilityTopMerchantView Kolom tersedia untuk kueri di tabel competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view	CompetitiveVisibilityBenchmarkView Kolom tersedia untuk kueri di tabel competitive_visibility_benchmark_view.

SearchRequest

Pesan permintaan untuk metode ReportService.Search.

Kolom
parent	string Wajib. ID akun yang melakukan panggilan. Harus berupa akun mandiri atau sub-akun MCA. Format: accounts/{account}
query	string Wajib. Kueri yang menentukan laporan yang akan diambil. Untuk detail tentang cara membuat kueri, lihat panduan Bahasa Kueri. Untuk daftar lengkap tabel dan kolom yang tersedia, lihat Kolom yang tersedia.
page_size	int32 Opsional. Jumlah ReportRows yang akan diambil dalam satu halaman. Default-nya adalah 1.000. Nilai di atas 5.000 dikonversi menjadi 5.000.
page_token	string Opsional. Token halaman yang akan diambil. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan. Untuk meminta halaman hasil berikutnya, nilai yang diperoleh dari next_page_token dalam respons sebelumnya harus digunakan.

SearchResponse

Pesan respons untuk metode ReportService.Search.

Kolom
results[]	ReportRow Baris yang cocok dengan kueri penelusuran.
next_page_token	string Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika dihilangkan, tidak ada halaman berikutnya.

TrafficSource

Jenis ini tidak memiliki kolom.

Sumber traffic tayangan di laporan Visibilitas kompetitif.

TrafficSourceEnum

Nilai sumber traffic.

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED	Tidak ditentukan.
ORGANIC	Traffic organik.
ADS	Traffic dari iklan.
ALL	Traffic organik dan iklan.