لمنح أحد الحسابات دور "مدير عمليات إعداد التقارير"، استخدِم
accounts.update إلى
اضبط الحقل reportingManager على true. دور مدير عمليات إعداد التقارير
يعادل دور "الأداء والإحصاءات" في Merchant Center
تستبدل accounts.update مورد Account بأكمله. استخدام accounts.get من أجل
الحصول على مورد Account بالكامل، ثم تقديم جميع الحقول في
طلب accounts.update حتى لا تفقد المعلومات.
نموذج طلب بحث
يسترد الاستعلام التالي impressions وclicks وctr لجميع
المنتجات في حسابك خلال فترة محددة تبلغ 30 يومًا. لتقديم الطلب،
تمرير عبارة لغة طلب البحث التالية في Merchant Center إلى
طريقة reports.search:
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
انقر على تشغيل لتجربة النموذج في مستكشف واجهات برمجة التطبيقات. بعد النقر
تشغيل، عدِّل العنصر النائب لمعرّف التاجر إلى معرّف التاجر في
لعنوان URL الخاص بالطلب. يمكنك تعديل طلب البحث. يجب أن يظل الاستعلام الكامل في سطر واحد
باستخدام مستكشف واجهات برمجة التطبيقات.
ويمكنك أيضًا تقسيم
في طلب البحث للحصول على تقارير أداء أكثر دقة.
اطّلِع على دليل المنتجات لمعرفة كيفية إجراء ذلك.
لاسترداد المنتجات وفلترتها باستخدام خدمة Reports.
تاريخ التعديل الأخير: 2024-09-20 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The `Reports` service allows you to retrieve performance metrics, such as impressions, clicks, and click-through rate (CTR), for your account."],["To 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 `accounts.update` method."],["A comprehensive list of available metrics can be found in the `metrics` documentation, and you can use Merchant Center Query Language to create customized reports."],["For more detailed analysis, you can segment your metrics and further explore report functionalities through the provided guides on segmentation and products."]]],["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"]]