Method: entityUsageReports.get

enum (EntityType)

מייצג את סוג הישות בדוח.

string

מייצג את המפתח של האובייקט שדרכו מסננים את הנתונים. זהו מחרוזת שיכולה לקבל את הערך all כדי לקבל אירועי פעילות לכל המשתמשים, או כל ערך אחר לישות ספציפית לאפליקציה. פרטים על אופן קבלת הערך של entityKey עבור entityType מסוים מופיעים במדריכים של פרמטרים של שימוש בישויות.

string

התאריך שבו התרחש השימוש, לפי שעון החוף המערבי (PST)‏ -8:00 (UTC). חותמת הזמן היא בפורמט ISO 8601, yyyy-mm-dd.

string

המזהה הייחודי של הלקוח שעבורו רוצים לאחזר נתונים.

string

מחרוזת השאילתה filters היא רשימה מופרדת בפסיקים של פרמטרים של אירועים של אפליקציה, שבה אופרטור יחסי משנה את ערך הפרמטר. מחרוזת השאילתה filters כוללת את שם האפליקציה שהשימוש שלה מוחזר בדוח. ערכי האפליקציה בדוח 'שימוש בישויות' כוללים את הערכים accounts,‏ docs ו-gmail.

המסננים הם בפורמט [application name]:[parameter name][relational operator][parameter value],....

בדוגמה הזו, האופרטור <> 'לא שווה' מקודד ככתובת URL במחרוזת השאילתה של הבקשה (%3C%3E):

GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0 

האופרטורים היחסיים כוללים:

• == – 'equal to'.
• <> – 'not equal to'. כתובת ה-URL מקודדת (%3C%3E).
• < - 'פחות מ-'. הוא מקודד ככתובת URL (‎%3C).
• <= – 'less than or equal to' (קטן מ- או שווה ל-). הוא מקודד ככתובת URL (‎%3C=).
• > – 'גדול מ-'. הוא מקודד כתובת URL (‎%3E).
• >= – 'גדול מ- או שווה ל-'. הוא מקודד ככתובת URL (‎%3E=).

integer (uint32 format)

קובע כמה רשומות פעילות יוצגו בכל דף תגובה. לדוגמה, אם הבקשה מגדירה את <span>maxResults=1</span> ויש בדוח שתי פעילויות, הדוח יכלול שני דפים. למאפיין <span>nextPageToken</span> של התשובה יש את האסימון לדף השני.

string

אסימון לציון הדף הבא. בדוח עם כמה דפים מופיע המאפיין nextPageToken בתגובה. בבקשה הבאה לקבלת הדף הבא של הדוח, מזינים את הערך nextPageToken במחרוזת השאילתה pageToken.

string

מחרוזת השאילתה parameters היא רשימה של פרמטרים של אירועים המופרדים בפסיקים, שמשמשת לטיהור התוצאות של דוח. הפרמטר משויך לאפליקציה ספציפית. ערכי האפליקציה בדוח 'שימוש בישויות' הם רק gplus.
מחרוזת שאילתה של parameter בפורמט CSV של [app_name1:param_name1], [app_name2:param_name2]....