rocket
Perkenalkan
Merchant API
- pengganti resmi Content API for Shopping.
add_alert
Catatan: Content API for Shopping akan dihentikan pada 18 Agustus 2026.
Mengukur performa
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Anda dapat menggunakan layanan Reports untuk mengambil performa
metrik untuk akun Anda.
Lihat dokumentasi metrics untuk mengetahui
daftar lengkap metrik yang tersedia.
Persyaratan
Anda memerlukan Pengelola pelaporan
peran untuk mengambil laporan ini.
Untuk memberikan peran Pengelola pelaporan kepada akun, gunakan
accounts.update ke
setel kolom reportingManager ke true. Peran Pengelola pelaporan
setara dengan peran Performa dan insight di Merchant Center.
accounts.update menggantikan seluruh resource Account. Gunakan accounts.get untuk
dapatkan resource Account lengkap, lalu berikan semua kolom di
accounts.update agar Anda tidak kehilangan informasi.
Contoh kueri
Kueri berikut mengambil impressions, clicks, dan ctr untuk semua
produk di akun Anda selama periode 30 hari tertentu. Untuk membuat permintaan,
teruskan pernyataan Bahasa Kueri Merchant Center berikut ke
Metode reports.search:
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
Eksekusi
Klik Run untuk mencoba contoh di API Explorer. Setelah Anda mengklik
Jalankan, perbarui placeholder ID penjual menjadi ID penjual Anda sendiri di
URL permintaan. Anda dapat mengubah kueri. Kueri lengkap harus tetap pada satu baris untuk
menggunakan API explorer.
Anda juga dapat menyegmentasikan
di kueri untuk laporan performa yang lebih terperinci.
Lihat Panduan produk untuk mempelajari caranya
untuk mengambil dan memfilter produk dengan layanan Reports.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eReports\u003c/code\u003e service allows you to retrieve performance metrics, such as impressions, clicks, and click-through rate (CTR), for your account.\u003c/p\u003e\n"],["\u003cp\u003eTo access this service, you must have the Reporting manager role (equivalent to the Performance and insights role in Merchant Center), which can be assigned using the \u003ccode\u003eaccounts.update\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive list of available metrics can be found in the \u003ccode\u003emetrics\u003c/code\u003e documentation, and you can use Merchant Center Query Language to create customized reports.\u003c/p\u003e\n"],["\u003cp\u003eFor more detailed analysis, you can segment your metrics and further explore report functionalities through the provided guides on segmentation and products.\u003c/p\u003e\n"]]],["The `Reports` service retrieves performance metrics, requiring the Reporting manager role. This role is enabled by setting `reportingManager` to `true` using `accounts.update`. To retain data, use `accounts.get` beforehand. `reports.search` uses Merchant Center Query Language, as demonstrated in a sample query that fetches `impressions`, `clicks`, and `ctr` for a given date range, and allows to run it in the API Explorer. Additionally, metrics can be segmented for detailed reports.\n"],null,["# Measure performance\n\nYou can use the `Reports` service to retrieve [performance\nmetrics](//support.google.com/merchants/answer/10265167) for your account.\n\nSee the [`metrics` documentation](/shopping-content/reference/rest/v2.1/reports/search#Metrics) for the\ncomplete list of available metrics.\n\nRequirements\n------------\n\nYou need the [Reporting manager\nrole](//support.google.com/merchants/answer/11935402) to retrieve this report.\n\nTo give an account the Reporting manager role, use\n[`accounts.update`](/shopping-content/reference/rest/v2.1/accounts/update) to\nset the `reportingManager` field to `true`. The Reporting manager role is\nequivalent to the Performance and insights role in Merchant Center.\n\n`accounts.update` replaces the entire `Account` resource. Use [`accounts.get`](/shopping-content/reference/rest/v2.1/accounts/get) to\nget the full `Account` resource, then provide all fields in your\n`accounts.update` request so you don't lose information.\n\nSample query\n------------\n\nThe following query retrieves the `impressions`, `clicks`, and `ctr` for all\nproducts in your account during a specific 30-day period. To make the request,\npass the following Merchant Center Query Language statement to the\n[`reports.search`](/shopping-content/reference/rest/v2.1/reports/search) method: \n\n SELECT\n metrics.impressions,\n metrics.clicks,\n metrics.ctr\n FROM MerchantPerformanceView\n WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'\n\n[Run](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search?apix=true&apix_params=%7B%22merchantId%22%3A0%2C%22resource%22%3A%7B%22query%22%3A%22SELECT%20%20metrics.impressions%2C%20%20metrics.clicks%2C%20%20metrics.ctr%20FROM%20MerchantPerformanceView%20WHERE%20segments.date%20BETWEEN%20%272020-12-01%27%20AND%20%272020-12-30%27%22%7D%7D)\n\nClick **Run** to try the sample in the **API Explorer** . After you click\n**Run** , update the merchant ID placeholder to your own merchant ID in the\nrequest URL. You can modify the query. The full query must remain on one line to\nwork with the **API explorer**.\n\nYou can also [segment](/shopping-content/guides/reports/segmentation) the\nmetrics in the query for more granular performance reports.\n\nSee the [Products guide](/shopping-content/guides/reports/products) to learn how\nto retrieve and filter products with the `Reports` service."]]
