כדי להקצות לחשבון את התפקיד 'מנהל דיווח', משתמשים ב-accounts.update כדי להגדיר את השדה reportingManager לערך true. רמת הגישה 'ניהול דוחות' שווה לרמת הגישה 'ביצועים ותובנות' ב-Merchant Center.
accounts.update מחליף את כל משאב Account. כדי לקבל את כל המידע על משאב Account, משתמשים ב-accounts.get ומספקים את כל השדות בבקשת accounts.update כדי לא לאבד מידע.
דוגמה לשאילתה
השאילתה הבאה מאחזרת את הערכים impressions, clicks ו-ctr של כל המוצרים בחשבון שלכם במהלך תקופה ספציפית של 30 יום. כדי לשלוח את הבקשה, צריך להעביר את ההצהרה הבאה של Merchant Center Query Language (MCQL) אל השיטה reports.search:
לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer. אחרי שלוחצים על Run (הפעלה), מעדכנים את placeholder מזהה המוכר למזהה המוכר שלכם בכתובת ה-URL של הבקשה. אפשר לשנות את השאילתה. כדי שהשאילתה תפעל עם API Explorer, היא צריכה להיות בשורה אחת.
אפשר גם לפלח את המדדים בשאילתה כדי לקבל דוחות ביצועים מפורטים יותר.
במדריך למוצרים מוסבר איך לאחזר ולסנן מוצרים באמצעות שירות Reports.
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2026-07-06 (שעון UTC)."],[],["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"]]