Package google.shopping.merchant.reports.v1beta

Indeks

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 lebih sedikit baris daripada yang ditentukan oleh page_size. Mengandalkan next_page_token untuk menentukan apakah ada lebih banyak baris yang akan diminta.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 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 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 jangka waktu seminggu atau sebulan.

Wajib ada dalam klausa SELECT. Kondisi pada report_granularity diperlukan dalam klausa WHERE.
report_country_code

string

Negara tempat peringkat dihitung. Ditampilkan dalam format ISO 3166.

Wajib ada 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 ada dalam klausa SELECT. Jika kondisi WHERE pada report_category_id tidak ditentukan dalam kueri, peringkat untuk semua kategori tingkat teratas akan ditampilkan.
brand

string

Nama brand.
rank

int64

Popularitas merek di platform Iklan dan organik, dalam kategori dan negara yang dipilih, berdasarkan perkiraan jumlah unit yang terjual.
previous_rank

int64

Peringkat popularitas pada minggu atau bulan sebelumnya.
relative_demand

RelativeDemandEnum

Estimasi permintaan dalam kaitannya dengan merek berperingkat popularitas tertinggi dalam kategori dan negara yang sama.
previous_relative_demand

RelativeDemandEnum

Estimasi permintaan dalam kaitannya dengan merek berperingkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.
relative_demand_change

RelativeDemandChangeTypeEnum

Perubahan estimasi permintaan. Apakah naik, turun, atau tetap datar.

BestSellersProductClusterView

Kolom yang tersedia untuk kueri di tabel best_sellers_product_cluster_view.

Laporan 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 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

Tingkat perincian laporan. Pemberian peringkat dapat dilakukan dalam jangka waktu seminggu atau sebulan.

Wajib ada dalam klausa SELECT. Kondisi pada report_granularity diperlukan dalam klausa WHERE.
report_country_code

string

Negara tempat peringkat dihitung. Ditampilkan 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 ada dalam klausa SELECT. Jika kondisi WHERE di report_category_id tidak ditentukan dalam kueri, peringkat untuk semua kategori level teratas akan ditampilkan.
title

string

Judul cluster produk.
brand

string

Merek cluster produk.
category_l1

string

Kategori produk (level 1) dari cluster produk, yang diwakili 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 (level 3) dari cluster produk, yang diwakili dalam taksonomi produk Google.
category_l4

string

Kategori produk (level 4) dari cluster produk, yang diwakili dalam taksonomi produk Google.
category_l5

string

Kategori produk (level 5) dari cluster produk, yang diwakili dalam taksonomi produk Google.
inventory_status

InventoryStatus

Apakah cluster produk adalah IN_STOCK di sumber data produk Anda di setidaknya 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

Apakah ada setidaknya satu produk dari merek yang saat ini IN_STOCK di sumber data produk Anda di setidaknya 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 platform Iklan dan organik, dalam kategori dan negara yang dipilih, berdasarkan perkiraan jumlah unit yang terjual.
previous_rank

int64

Peringkat popularitas pada minggu atau bulan sebelumnya.
relative_demand

RelativeDemandEnum

Estimasi permintaan dalam kaitannya dengan cluster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama.
previous_relative_demand

RelativeDemandEnum

Estimasi permintaan dalam kaitannya dengan cluster produk dengan peringkat popularitas tertinggi dalam kategori dan negara yang sama pada minggu atau bulan sebelumnya.
relative_demand_change

RelativeDemandChangeTypeEnum

Perubahan estimasi permintaan. Apakah naik, turun, atau tetap datar.

InventoryStatus

Status cluster atau merek produk di inventaris Anda.

Enum
INVENTORY_STATUS_UNSPECIFIED Tidak ditentukan.
IN_STOCK Anda memiliki produk untuk cluster produk atau merek ini yang tersedia.
OUT_OF_STOCK Anda memiliki produk untuk cluster produk atau merek ini di inventaris, tetapi saat ini stoknya habis.
NOT_IN_INVENTORY Anda tidak memiliki produk untuk merek atau cluster produk ini dalam inventaris.

CompetitiveVisibilityBenchmarkView

Kolom yang 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 ada dalam klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.
report_country_code

string

Negara tempat tayangan muncul.

Wajib ada 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 direpresentasikan dalam taksonomi produk Google.

Wajib ada dalam klausa SELECT. Kondisi pada report_category_id diperlukan dalam klausa WHERE.
traffic_source

TrafficSourceEnum

Sumber traffic tayangan.

Wajib ada 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 dapat difilter dalam klausa 'WHERE'.
category_benchmark_visibility_trend

double

Perubahan visibilitas berdasarkan tayangan sehubungan dengan awal rentang waktu yang dipilih (atau hari pertama dengan tayangan non-nol) untuk kumpulan gabungan penjual dengan visibilitas tertinggi yang mendekati pasar.

Tidak dapat difilter dalam klausa 'WHERE'.

CompetitiveVisibilityCompetitorView

Kolom yang 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' bernilai benar.

Wajib ada dalam klausa SELECT. Tidak dapat difilter dalam klausa 'WHERE'.
is_your_domain

bool

Benar jika baris ini berisi data untuk domain Anda.

Tidak dapat difilter pada klausa 'WHERE'.
report_country_code

string

Negara tempat tayangan muncul.

Wajib ada dalam klausa SELECT. Kondisi pada report_country_code diperlukan dalam klausa WHERE.
report_category_id

int64

ID kategori produk Google untuk menghitung laporan, yang diwakili dalam taksonomi produk Google.

Wajib ada dalam klausa SELECT. Kondisi pada report_category_id diperlukan dalam klausa WHERE.
traffic_source

TrafficSourceEnum

Sumber traffic tayangan.

Wajib ada dalam klausa SELECT.
rank

int64

Posisi domain dalam peringkat bisnis serupa untuk kunci yang dipilih (date, report_category_id, report_country_code, traffic_source) berdasarkan tayangan. 1 adalah yang tertinggi.

Tidak dapat difilter dalam 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 dapat difilter pada klausa 'WHERE'.
page_overlap_rate

double

Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama.

Tidak dapat difilter dalam 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 dapat difilter dalam klausa 'WHERE'.
relative_visibility

double

Visibilitas relatif menunjukkan seberapa sering penawaran pesaing Anda ditampilkan dibandingkan dengan penawaran Anda. Dengan kata lain, visibilitas relatif adalah jumlah tayangan yang ditampilkan dari retailer pesaing dibagi dengan jumlah tayangan Anda yang ditampilkan selama rentang waktu yang dipilih untuk kategori produk dan negara yang dipilih.

Tidak dapat difilter dalam klausa 'WHERE'.

CompetitiveVisibilityTopMerchantView

Kolom yang 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 di klausa SELECT. Kondisi pada date diperlukan dalam klausa WHERE.
domain

string

Domain pesaing atau domain Anda, jika 'is_your_domain' benar.

Wajib ada dalam klausa SELECT. Tidak dapat difilter dalam klausa 'WHERE'.
is_your_domain

bool

Benar jika baris ini berisi data untuk domain Anda.

Tidak dapat 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 untuk menghitung laporan, yang diwakili dalam taksonomi produk Google.

Wajib ada 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 dalam peringkat penjual teratas untuk kunci yang dipilih (date, report_category_id, report_country_code, traffic_source) berdasarkan tayangan. 1 adalah yang tertinggi.

Tidak dapat difilter dalam 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 dapat difilter dalam klausa 'WHERE'.
page_overlap_rate

double

Rasio tumpang-tindih halaman menunjukkan seberapa sering penawaran retailer pesaing ditampilkan bersama dengan penawaran Anda di halaman yang sama.

Tidak dapat difilter dalam 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 dapat difilter dalam klausa 'WHERE'.

MarketingMethod

Jenis ini tidak memiliki kolom.

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

MarketingMethodEnum

Nilai metode pemasaran.

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

NonProductPerformanceView

Kolom yang tersedia untuk kueri di tabel non_product_performance_view.

Data performa pada gambar dan link toko online yang mengarah ke halaman non-produk Anda. Hal ini mencakup metrik performa (misalnya, clicks) dan dimensi yang digunakan untuk menyegmentasikan metrik performa (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 dalam zona waktu penjual tempat metrik berlaku. Segmen.

Kondisi pada date diperlukan dalam klausa WHERE.
week

Date

Hari pertama (Senin) tanggal metrik dalam 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 yang tersedia untuk kueri di tabel price_competitiveness_product_view.

Laporan Persaingan harga.

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

Kolom
price

Price

Harga produk saat ini.
benchmark_price

Price

Patokan harga terbaru yang tersedia untuk katalog produk di negara patokan.
report_country_code

string

Negara patokan harga. Diwakili dalam format ISO 3166.

Wajib ada dalam klausa SELECT.
id

string

ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Dapat digunakan untuk menggabungkan data dengan tabel product_view.

Wajib ada dalam klausa SELECT.
offer_id

string

ID produk yang disediakan penjual.
title

string

Judul produk.
brand

string

Merek produk.
category_l1

string

Kategori produk (level 1) di taksonomi produk Google.
category_l2

string

Kategori produk (tingkat 2) dalam taksonomi produk Google.
category_l3

string

Kategori produk (level 3) di taksonomi produk Google.
category_l4

string

Kategori produk (level 4) di taksonomi produk Google.
category_l5

string

Kategori produk (level 5) di taksonomi produk Google.
product_type_l1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.
product_type_l2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri.
product_type_l3

string

Jenis produk (tingkat 3) di taksonomi produk milik penjual.
product_type_l4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri.
product_type_l5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri.

PriceInsightsProductView

Kolom yang tersedia untuk kueri di tabel price_insights_product_view.

Laporan 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 ada dalam klausa SELECT.
offer_id

string

ID produk yang disediakan penjual.
title

string

Judul produk.
brand

string

Merek produk.
category_l1

string

Kategori produk (level 1) di taksonomi produk Google.
category_l2

string

Kategori produk (level 2) di taksonomi produk Google.
category_l3

string

Kategori produk (tingkat 3) dalam taksonomi produk Google.
category_l4

string

Kategori produk (level 4) di taksonomi produk Google.
category_l5

string

Kategori produk (level 5) di taksonomi produk Google.
product_type_l1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.
product_type_l2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri.
product_type_l3

string

Jenis produk (tingkat 3) dalam taksonomi produk penjual sendiri.
product_type_l4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri.
product_type_l5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri.
predicted_impressions_change_fraction

double

Prediksi perubahan tayangan sebagai 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 sebagai pecahan setelah memperkenalkan harga yang disarankan dibandingkan dengan harga aktif saat ini. Misalnya, 0,05 adalah prediksi peningkatan konversi sebesar 5%).

Efektivitas

Bucket efektivitas yang 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 Efektivitasnya tinggi.

ProductPerformanceView

Kolom yang tersedia untuk kueri di tabel product_performance_view.

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

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

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

Kolom
date

Date

Tanggal dalam zona waktu penjual tempat metrik berlaku. 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, yang dilaporkan pada tanggal konversi. Metrik.

Hanya tersedia untuk sumber traffic FREE.
marketing_method

MarketingMethodEnum

Metode pemasaran yang berlaku untuk metrik. Segmen.
customer_country_code

string

Kode negara tempat pelanggan berada pada saat peristiwa terjadi. Diwakili dalam format ISO 3166. Segmen.

Jika negara pelanggan tidak dapat ditentukan, kode 'ZZ' khusus akan ditampilkan.
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 (level 2) dalam taksonomi produk Google. Segmen.
category_l3

string

Kategori produk (level 3) dalam taksonomi produk Google. Segmen.
category_l4

string

Kategori produk (level 4) dalam taksonomi produk Google. Segmen.
category_l5

string

Kategori produk (level 5) dalam taksonomi produk Google. Segmen.
product_type_l1

string

Jenis produk (tingkat 1) di taksonomi produk milik penjual. Segmen.
product_type_l2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri. Segmen.
product_type_l3

string

Jenis produk (tingkat 3) dalam taksonomi produk penjual sendiri. Segmen.
product_type_l4

string

Jenis produk (tingkat 4) dalam taksonomi produk penjual sendiri. Segmen.
product_type_l5

string

Tipe produk (tingkat 5) di taksonomi produk milik penjual. Segmen.
custom_label0

string

Label kustom 0 untuk pengelompokan produk kustom. Segmen.
custom_label1

string

Label kustom 1 untuk pengelompokan produk kustom. Segmen.
custom_label2

string

Label khusus 2 untuk pengelompokan produk secara khusus. Segmen.
custom_label3

string

Label kustom 3 untuk pengelompokan produk kustom. Segmen.
custom_label4

string

Label kustom 4 untuk pengelompokan produk kustom. 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 setiap klik mendapatkan kreditnya sendiri. 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 yang tersedia untuk kueri di tabel product_view.

Produk dalam inventaris saat ini. Produk dalam tabel ini sama dengan 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 pemfilteran daftar produk yang ditampilkan berdasarkan atribut produk. Untuk mengambil satu produk berdasarkan 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 untuk produk, yang ditentukan saat penyisipan.
item_issues[]

ItemIssue

Daftar masalah item untuk produk.

Kolom ini tidak dapat digunakan untuk mengurutkan hasil.

Hanya atribut yang dipilih dari kolom ini (misalnya, item_issues.severity.aggregated_severity) yang dapat digunakan untuk memfilter hasil.
click_potential

ClickPotential

Perkiraan potensi performa dibandingkan dengan produk penjual yang berperforma tertinggi.
id

string

ID REST produk, dalam bentuk channel~languageCode~feedLabel~offerId. Metode Merchant API yang beroperasi pada produk menggunakan ini sebagai parameter name.

Wajib ada 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) dalam taksonomi produk Google.
category_l2

string

Kategori produk (level 2) di taksonomi produk Google.
category_l3

string

Kategori produk (tingkat 3) dalam taksonomi produk Google.
category_l4

string

Kategori produk (level 4) di taksonomi produk Google.
category_l5

string

Kategori produk (tingkat 5) dalam taksonomi produk Google.
product_type_l1

string

Jenis produk (tingkat 1) dalam taksonomi produk penjual sendiri.
product_type_l2

string

Jenis produk (tingkat 2) dalam taksonomi produk penjual sendiri.
product_type_l3

string

Jenis produk (tingkat 3) dalam taksonomi produk penjual sendiri.
product_type_l4

string

Jenis produk (tingkat 4) di taksonomi produk milik penjual.
product_type_l5

string

Jenis produk (tingkat 5) dalam taksonomi produk penjual sendiri.
condition

string

Kondisi produk.
availability

string

Ketersediaan produk.
shipping_label

string

Label pengiriman yang dinormalisasi yang ditentukan di sumber data.
item_group_id

string

ID kelompok item yang diberikan oleh penjual untuk mengelompokkan varian.
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
Disetujui Disetujui VALID
Disetujui Tertunda VALID
Disetujui 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 beberapa (tetapi tidak semua) konteks pelaporan.
ELIGIBLE Produk memenuhi syarat untuk semua konteks pelaporan.

ClickPotential

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

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 sedang dibandingkan dengan produk penjual yang memiliki performa tertinggi.
HIGH Berpotensi menerima jumlah klik yang serupa dengan produk penjual berperforma 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, crawling gambar) atau melalui peninjauan Google. Anda tidak perlu melakukan tindakan apa pun saat ini. Penyelesaian mungkin menyebabkan masalah lain (misalnya, jika crawl gagal).

ItemIssueSeverity

Pengaruh masalah terhadap penayangan produk.

Kolom
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Tingkat keparahan masalah per konteks pelaporan.
aggregated_severity

AggregatedIssueSeverity

Gabungan tingkat keparahan masalah untuk semua konteks pelaporan yang terpengaruh.

Kolom ini dapat digunakan untuk memfilter hasil.

AggregatedIssueSeverity

Tingkat keparahan masalah yang digabungkan untuk semua konteks pelaporan.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Tidak ditentukan.
DISAPPROVED Masalah tidak menyetujui produk dalam setidaknya satu konteks pelaporan.
DEMOTED Masalah akan mendemosikan produk di 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 direpresentasikan dalam format ISO 3166.
demoted_countries[]

string

Daftar negara yang diturunkan peringkatnya dalam konteks pelaporan, yang direpresentasikan dalam format ISO 3166.
reporting_context

ReportingContextEnum

Konteks pelaporan tempat masalah diterapkan.

ItemIssueType

Jenis masalah.

Kolom
code

string

Kode error masalah, setara dengan code dari Masalah produk.
canonical_attribute

string

Nama atribut kanonis untuk masalah khusus atribut.

RelativeDemand

Jenis ini tidak memiliki kolom.

Permintaan relatif cluster produk atau merek dalam laporan Terlaris.

RelativeDemandEnum

Nilai permintaan relatif.

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

RelativeDemandChangeType

Jenis ini tidak memiliki kolom.

Permintaan relatif cluster produk atau merek dalam 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 dari jangka waktu sebelumnya.
FLAT Permintaan relatif sama dengan jangka waktu sebelumnya.
RISER Permintaan relatif lebih tinggi dari jangka waktu sebelumnya.

ReportGranularity

Jenis ini tidak memiliki kolom.

Tingkat perincian laporan Terlaris. Laporan terlaris dihitung selama jangka waktu seminggu dan sebulan.

ReportGranularityEnum

Melaporkan 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 akan diisi dalam respons. Dalam pesan yang diisi, hanya kolom yang diminta secara eksplisit dalam kueri yang akan diisi.

Kolom
product_performance_view

ProductPerformanceView

Kolom yang 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 yang 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 yang 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 yang tersedia untuk kueri di tabel best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Kolom yang tersedia untuk kueri di tabel competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Kolom yang tersedia untuk kueri di tabel competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Kolom yang 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 Anda, lihat panduan Bahasa Kueri. Untuk mengetahui daftar lengkap tabel dan kolom yang tersedia, lihat Kolom yang tersedia.
page_size

int32

Opsional. Jumlah ReportRows yang akan diambil dalam satu halaman. Setelan defaultnya adalah 1.000. Nilai di atas 5.000 akan 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.