rocket
Content API for Shopping'in resmi olarak yerini alacak olan
Merchant API ile tanışın.
add_alert
Not: Content API for Shopping, 18 Ağustos 2026'da kullanımdan kaldırılacak.
Performansı ölçün
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Performansı almak için Reports hizmetini kullanabilirsiniz
metrikleri görebilirsiniz.
Şu sürüm için metrics dokümanlarını inceleyin:
mevcut metriklerin tam listesini inceleyin.
Şartlar
Daha fazla bilgi için Raporlama yöneticisine
rolüyle birlikte gelir.
Bir hesaba Raporlama yöneticisi rolü vermek için
accounts.update -
reportingManager alanını true olarak ayarlayın. Raporlama yöneticisi rolü
Merchant Center'daki "Performans ve analizler" rolüyle eşdeğerdir.
accounts.update, tüm Account kaynağının yerini alır. accounts.get kullanarak şu işlemleri yapabilirsiniz:
Account kaynağının tamamını edinin ve ardından
Bilgileri kaybetmemeniz için accounts.update isteği.
Örnek sorgu
Aşağıdaki sorgu, tüm eşleme türleri için impressions, clicks ve ctr verilerini getirir.
30 günlük bir dönem boyunca hesabınıza yansıyan ürünlerdir. Talepte bulunmak için
aşağıdaki Merchant Center Sorgu Dili ifadesini
reports.search yöntemi:
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
Çalıştır
Örneği API Gezgini'nde denemek için Çalıştır'ı tıklayın. Tıkladıktan sonra
Çalıştır'ı tıkladıktan sonra, satıcı kimliği yer tutucusunu
istek URL'si. Sorguyu değiştirebilirsiniz. Aşağıdaki işlemler için tüm sorgunun bir satırda kalması gerekir:
API gezgini ile çalışın.
Ayrıca, segmentlere ayırma
metriklerinizi sorgulayın.
Nasıl yapılacağını öğrenmek için Ürün rehberine bakın.
Reports hizmetiyle ürünleri almak ve filtrelemek için.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
