Method: activities.list

מאחזר רשימה של פעילויות בחשבון ובאפליקציה ספציפיים של לקוח, כמו אפליקציית Google Admin או אפליקציית Google Drive. מידע נוסף זמין במדריכים בנושא דוחות פעילות של אדמינים ושל Google Drive. מידע נוסף על הפרמטרים של דוח הפעילות זמין במדריכי העזר בנושא פרמטרים של פעילות.

בקשת HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
userKey or all

string

מייצג את מזהה הפרופיל או את האימייל של המשתמש שלפיו צריך לסנן את הנתונים. יכול להיות all לכל המידע, או userKey למזהה הייחודי של פרופיל Google Workspace של המשתמש או לכתובת האימייל הראשית שלו. המשתמש לא יכול להיות משתמש שנמחק. עבור משתמש שנמחק, קוראים ל-users.list ב-Directory API עם showDeleted=true, ואז משתמשים ב-ID שמוחזר בתור userKey.
applicationName

enum (ApplicationName)

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

פרמטרים של שאילתה

פרמטרים
actorIpAddress

string

כתובת פרוטוקול האינטרנט (IP) של המארח שבו בוצע האירוע. זו דרך נוספת לסנן את הסיכום של דוח לפי כתובת ה-IP של המשתמש שהפעילות שלו מדווחת. יכול להיות שכתובת ה-IP הזו תשקף את המיקום הפיזי של המשתמש, ויכול להיות שלא. לדוגמה, כתובת ה-IP יכולה להיות הכתובת של שרת ה-proxy של המשתמש או כתובת של רשת וירטואלית פרטית (VPN). הפרמטר הזה תומך בגרסאות של כתובות IPv4 ו-IPv6.
customerId

string

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

string

מגדיר את סוף טווח הזמן שמוצג בדוח. התאריך הוא בפורמט RFC 3339, לדוגמה 2010-10-28T10:26:35.000Z. ערך ברירת המחדל הוא הזמן המשוער של בקשת ה-API. בדוח API יש שלושה מושגי זמן בסיסיים:

  • התאריך של בקשת ה-API לדוח: התאריך שבו ה-API יצר ואחזר את הדוח.
  • שעת ההתחלה של הדוח: תחילת טווח הזמן שמוצג בדוח. הערך של startTime צריך להיות לפני הערך של endTime (אם הוא צוין) ולפני השעה הנוכחית בזמן שליחת הבקשה, אחרת ה-API יחזיר שגיאה.
  • שעת הסיום של הדוח: סוף טווח הזמן שמוצג בדוח. לדוגמה, טווח הזמן של אירועים שמסוכמים בדוח יכול להתחיל באפריל ולהסתיים במאי. אפשר לבקש את הדוח עצמו באוגוסט.
אם לא מציינים את endTime, הדוח מחזיר את כל הפעילויות מ-startTime עד השעה הנוכחית, או מ-180 הימים האחרונים אם startTime חל לפני יותר מ-180 ימים.

בבקשות שקשורות ל-Gmail, startTime ו-endTime חייבים להיות מצורפים, וההפרש ביניהם לא יכול להיות גדול מ-30 יום.
eventName

string

שם האירוע שנשלח לגביו שאילתה באמצעות ה-API. כל eventName קשור לשירות או לתכונה ספציפיים של Google Workspace, שה-API מארגן לסוגים של אירועים. דוגמה לכך היא האירועים ביומן Google בדוחות של אפליקציית מסוף Admin. המבנה של Calendar Settings type כולל את כל הפעילויות ביומן eventName שמדווחות על ידי ה-API. כשאדמין משנה הגדרה ביומן, ה-API מדווח על הפעילות הזו בפרמטרים של הגדרות היומן type ו-eventName. מידע נוסף על פרמטרים ומחרוזות של שאילתות זמין ברשימת שמות האירועים לאפליקציות שונות שלמעלה בקטע applicationName.eventName
filters

string

מחרוזת השאילתה filters היא רשימה מופרדת בפסיקים שמורכבת מפרמטרים של אירועים שעברו מניפולציה על ידי אופרטורים יחסיים. הפרמטרים של האירועים הם מהצורה {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

פרמטרים של אירועים כאלה משויכים לeventName ספציפי. אם הפרמטר של הבקשה לא שייך ל-eventName, יוחזר דוח ריק. מידע נוסף על השדות הזמינים eventName לכל אפליקציה והפרמטרים שמשויכים אליהם זמין בטבלה ApplicationName. כדי לעבור לדף Activity Events (אירועי פעילות) באפליקציה הרצויה, לוחצים על הקישור בנספח.

בדוגמאות הבאות של פעילות ב-Drive, הרשימה שמוחזרת כוללת את כל האירועים מסוג edit שבהם ערך הפרמטר doc_id תואם לתנאים שהוגדרו על ידי האופרטור הרלציוני. בדוגמה הראשונה, הבקשה מחזירה את כל המסמכים שנערכו עם ערך doc_id ששווה ל-12345. בדוגמה השנייה, הדוח מחזיר את כל המסמכים שנערכו שבהם הערך של doc_id לא שווה ל-98765. האופרטור <> מקודד בכתובת ה-URL במחרוזת השאילתה של הבקשה (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters שאילתה תומכת באופרטורים הרלציוניים הבאים:

  • == – 'שווה ל'.
  • ‫<> – 'לא שווה לערך'. הקידוד חייב להיות לפי כתובת URL (%3C%3E).
  • ‫<—'פחות מ'. חייב להיות מקודד בקידוד URL ‏ (%3C).
  • ‫<= – 'קטן מ- או שווה ל-'. חייב להיות מקודד בקידוד URL ‏ (%3C=).
  • > – 'גדול מ'. חייב להיות מקודד בקידוד URL ‏ (%3E).
  • ‫>=—'גדול מ- או שווה ל-'. הקידוד חייב להיות לפי כתובת URL ‏ (%3E=).

הערה: ה-API לא מקבל כמה ערכים של אותו פרמטר. אם פרמטר מסופק יותר מפעם אחת בבקשת ה-API, ה-API מקבל רק את הערך האחרון של הפרמטר הזה. בנוסף, אם בבקשת ה-API מצוין פרמטר לא תקין, ה-API מתעלם מהפרמטר הזה ומחזיר את התגובה שמתאימה לפרמטרים התקינים שנותרו. אם לא נשלחת בקשה לפרמטרים, כל הפרמטרים מוחזרים.
maxResults

integer

קובע כמה רשומות של פעילות מוצגות בכל דף של תשובות. לדוגמה, אם הבקשה מגדירה maxResults=1 והדוח כולל שתי פעילויות, הדוח כולל שני דפים. המאפיין nextPageToken בתגובה מכיל את הטוקן של הדף השני. מחרוזת השאילתה maxResults היא אופציונלית בבקשה. ערך ברירת המחדל הוא 1,000.
orgUnitID

string

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

pageToken

string

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

string

מגדיר את תחילת טווח הזמן שמוצג בדוח. התאריך הוא בפורמט RFC 3339, לדוגמה 2010-10-28T10:26:35.000Z. הדוח מחזיר את כל הפעילויות מ-startTime עד endTime. הערך של startTime צריך להיות לפני הערך של endTime (אם הוא צוין) ולפני השעה הנוכחית בזמן שליחת הבקשה, אחרת ה-API יחזיר שגיאה.

בבקשות שקשורות ל-Gmail, startTime ו-endTime חייבים להיות מצורפים, וההפרש ביניהם לא יכול להיות גדול מ-30 יום.
groupIdFilter

string

מזהי קבוצות (מוסתרים) מופרדים בפסיקים שפעילויות המשתמשים מסוננות לפיהם, כלומר התגובה תכיל פעילויות רק של משתמשים ששייכים לפחות לאחד ממזהי הקבוצות שמוזכרים כאן. פורמט: id:abc123,id:xyz456

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תבנית JSON לאוסף פעילויות.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
שדות
kind

string

סוג משאב ה-API. בדוח פעילות, הערך הוא reports#activities.
etag

string

‫ETag של המשאב.
items[]

object (Activity)

כל רשומה של פעילות בתגובה.
nextPageToken

string

טוקן לאחזור הדף הבא של הדוח. הערך nextPageToken משמש במחרוזת השאילתה pageToken של הבקשה.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

מידע נוסף זמין במדריך ההרשאות.

ApplicationName

טיפוסים בני מנייה (enum)
access_transparency

דוחות הפעילות של Access Transparency ב-Google Workspace מחזירים מידע על סוגים שונים של אירועי פעילות של Access Transparency.
admin

דוחות הפעילות של אפליקציית מסוף Admin מחזירים פרטי חשבון לגבי סוגים שונים של אירועי פעילות של אדמינים.
calendar

דוחות הפעילות של אפליקציית יומן Google מחזירים מידע על אירועים שונים של פעילות ביומן.
chat בדוחות על הפעילות ב-Chat מוצג מידע על אירועים שונים של פעילות ב-Chat.
drive

דוחות הפעילות של אפליקציית Google Drive מחזירים מידע על אירועי פעילות שונים ב-Google Drive. דוח הפעילות ב-Drive זמין רק ללקוחות Google Workspace Business ו-Enterprise.
gcp בדוחות הפעילות של אפליקציית Google Cloud Platform מופיע מידע על אירועי פעילות שונים ב-GCP.
gmail בדוחות הפעילות של אפליקציית Gmail מופיע מידע על אירועי פעילות שונים ב-Gmail.
gplus דוחות הפעילות של אפליקציית Google+‎ מחזירים מידע על אירועי פעילות שונים ב-Google+‎.
groups

בדוחות הפעילות של אפליקציית Google Groups מופיע מידע על אירועי פעילות שונים בקבוצות.
groups_enterprise

בדוחות הפעילות של קבוצות Enterprise מופיע מידע על אירועי פעילות שונים של קבוצות Enterprise.
jamboard בדוחות הפעילות של Jamboard מופיע מידע על אירועי פעילות שונים ב-Jamboard.
login

בדוחות הפעילות של אפליקציית הכניסה מופיעים פרטי חשבון לגבי סוגים שונים של אירועי פעילות בכניסה.
meet בדוח הפעילות של ביקורת Meet מופיע מידע על סוגים שונים של אירועי פעילות של ביקורת Meet.
mobile בדוח הפעילות 'ביקורת מכשירים' מופיע מידע על סוגים שונים של אירועי פעילות של ביקורת מכשירים.
rules

בדוח 'פעילות של כללים' מוצג מידע על סוגים שונים של אירועים של פעילות כללים.
saml

בדוח הפעילות של SAML מופיע מידע על סוגים שונים של אירועי פעילות של SAML.
token

בדוחות הפעילות של אפליקציית האסימון מופיע מידע על החשבון לגבי סוגים שונים של אירועי פעילות של אסימונים.
user_accounts

בדוחות הפעילות של אפליקציית חשבונות המשתמשים מופיע מידע על חשבונות לגבי סוגים שונים של אירועי פעילות בחשבונות משתמשים.
context_aware_access

בדוחות הפעילות של בקרת גישה מבוססת-הקשר מופיע מידע על אירועים שבהם הגישה של משתמשים נדחתה בגלל כללים של בקרת גישה מבוססת-הקשר.
chrome

דוחות הפעילות ב-Chrome מחזירים מידע על אירועים בדפדפן Chrome וב-Chrome OS.
data_studio בדוחות הפעילות של Data Studio מופיע מידע על סוגים שונים של אירועי פעילות ב-Data Studio.
keep בדוחות הפעילות של אפליקציית Keep מופיע מידע על אירועי פעילות שונים ב-Google Keep. דוח הפעילות ב-Keep זמין רק ללקוחות Google Workspace Business ו-Enterprise.
vault בדוחות הפעילות של Vault מופיע מידע על סוגים שונים של אירועי פעילות ב-Vault.
gemini_in_workspace_apps דוחות הפעילות ב-Gemini ל-Workspace מחזירים מידע על סוגים שונים של אירועי פעילות ב-Gemini שבוצעו על ידי משתמשים באפליקציית Workspace.
classroom בדוחות הפעילות ב-Classroom מופיע מידע על סוגים שונים של אירועי פעילות ב-Classroom.

פעילות

תבנית JSON למשאב הפעילות.

ייצוג ב-JSON 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
שדות
kind

string

סוג משאב ה-API. בדוח פעילות, הערך הוא audit#activity.
etag

string

‫ETag של הרשומה.
ownerDomain

string

זהו הדומיין שהושפע מהאירוע בדוח. לדוגמה, הדומיין של מסוף Admin או של הבעלים של המסמך באפליקציית Drive.
ipAddress

string

כתובת ה-IP של המשתמש שביצע את הפעולה. זוהי כתובת פרוטוקול האינטרנט (IP) של המשתמש בזמן הכניסה ל-Google Workspace, שיכולה לשקף את המיקום הפיזי של המשתמש או לא. לדוגמה, כתובת ה-IP יכולה להיות הכתובת של שרת ה-proxy של המשתמש או כתובת של רשת וירטואלית פרטית (VPN). ה-API תומך ב-IPv4 וב-IPv6.
events[]

object

אירועי פעילות בדוח.
events[].type

string

סוג האירוע. שירות או תכונה של Google Workspace שאדמין משנה מזוהים במאפיין type שמזהה אירוע באמצעות המאפיין eventName. רשימה מלאה של קטגוריות ה-API זמינה ברשימת שמות האירועים לאפליקציות שונות שמופיעה למעלה בapplicationName.type
events[].name

string

שם האירוע. זהו השם הספציפי של הפעילות שדווחה על ידי ה-API. כל eventName קשור לשירות או לתכונה ספציפיים של Google Workspace, שה-API מארגן לסוגים של אירועים.
לגבי פרמטרים של בקשות eventName באופן כללי:

  • אם לא מציינים eventName, הדוח מחזיר את כל המופעים האפשריים של eventName.
  • כשמבקשים eventName, התגובה של ה-API מחזירה את כל הפעילויות שמכילות את eventName.

מידע נוסף על מאפייני eventName זמין ברשימת שמות האירועים של אפליקציות שונות שמופיעה למעלה בקטע applicationName.
events[].parameters[]

object

זוגות של ערכי פרמטרים לאפליקציות שונות. מידע נוסף על פרמטרים של eventName זמין ברשימת שמות האירועים שלמעלה עבור אפליקציות שונות ב-applicationName.
events[].parameters[].messageValue

object

צמדי ערכי פרמטרים מקוננים שמשויכים לפרמטר הזה. סוג ערך מורכב של פרמטר מוחזר כרשימה של ערכי פרמטרים. לדוגמה, לפרמטר של הכתובת יכול להיות ערך כמו [{parameter: [{name: city, value: abc}]}]
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

ערכי פרמטרים
events[].parameters[].name

string

שם הפרמטר.
events[].parameters[].value

string

ערך המחרוזת של הפרמטר.
events[].parameters[].multiValue[]

string

ערכי המחרוזת של הפרמטר.
events[].parameters[].intValue

string (int64 format)

ערך הפרמטר כמספר שלם.
events[].parameters[].multiIntValue[]

string (int64 format)

ערכים שלמים של הפרמטר.
events[].parameters[].boolValue

boolean

הערך הבוליאני של הפרמטר.
events[].parameters[].multiMessageValue[]

object

activities.list of messageValue objects.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

ערכי פרמטרים
events[].resourceIds[]

string

מזהי משאבים שמשויכים לאירוע.
id

object

מזהה ייחודי לכל רשומה של פעילות.
id.time

string

השעה שבה הפעילות התרחשה. הערך הזה הוא חותמת זמן של מערכת Unix בשניות.
id.uniqueQualifier

string (int64 format)

מזהה ייחודי אם לכמה אירועים יש את אותו זמן.
id.applicationName

string

שם האפליקציה שאליה משויך האירוע. רשימת הערכים האפשריים מופיעה למעלה בקטע applicationName.
id.customerId

string

המזהה הייחודי של חשבון Google Workspace.
actor

object

המשתמש שמבצע את הפעולה.
actor.profileId

string

המזהה הייחודי של הפרופיל ב-Google Workspace של השחקן. יכול להיות שהערך הזה לא יופיע אם השחקן הוא לא משתמש Google Workspace, או שהוא יהיה המספר 105250506097979753968 שמשמש כמזהה placeholder.
actor.email

string

כתובת האימייל הראשית של המשתמש. יכול להיות שלא יופיע אם אין כתובת אימייל שמשויכת לשחקן.
actor.callerType

string

סוג המשתמש.
actor.key

string

מוצג רק אם הערך של callerType הוא KEY. יכול להיות consumer_key של שולח הבקשה עבור בקשות API של OAuth 2LO או מזהה של חשבונות רובוט.
actor.applicationInfo

object

פרטים של האפליקציה שהייתה הגורם הפעיל בפעילות.
actor.applicationInfo.oauthClientId

string

מזהה הלקוח ב-OAuth של אפליקציית הצד השלישי ששימשה לביצוע הפעולה.
actor.applicationInfo.applicationName

string

שם האפליקציה שבה השתמשתם כדי לבצע את הפעולה.
actor.applicationInfo.impersonation

boolean

האם האפליקציה התחזתה למשתמש.
networkInfo

object (NetworkInfo)

מידע על הרשת של המשתמש שמבצע את הפעולה.
resourceDetails[]

object (ResourceDetails)

פרטים על המשאב שעליו בוצעה הפעולה.

NetworkInfo

מידע על הרשת של המשתמש שמבצע את הפעולה.

ייצוג ב-JSON 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
שדות
ipAsn[]

integer

כתובת ה-IP של המשתמש שביצע את הפעולה.
regionCode

string

קוד אזור לפי תקן ISO 3166-1 alpha-2 של המשתמש שמבצע את הפעולה.
subdivisionCode

string

קוד אזור לפי תקן ISO 3166-2 (מדינות ומחוזות) במדינות של המשתמש שמבצע את הפעולה.

ResourceDetails

פרטים על המשאב שעליו בוצעה הפעולה.

ייצוג ב-JSON 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
שדות
id

string

מזהה המשאב.
title

string

שם המשאב. לדוגמה, במקרה של מסמך ב-Drive, זה יהיה שם המסמך. במקרה של אימייל, זה יהיה הנושא.
type

string

סוג המשאב – מסמך, אימייל, הודעה בצ'אט
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

הגדרת הקשר בין המשאב לבין האירועים

AppliedLabel

פרטים על התווית שהוחלה על המשאב.

ייצוג ב-JSON 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
שדות
id

string

מזהה התווית – רק מזהה התווית, ולא שם המשאב המלא ב-OnePlatform.
title

string

שם התווית
fieldValues[]

object (FieldValue)

activities.list of fields which are part of the label and have been set by the user. אם לתווית יש שדה שהמשתמש לא הגדיר, היא לא תופיע ברשימה הזו.
reason

object (Reason)

הסיבה להחלת התווית על המשאב.

FieldValue

פרטים על ערך השדה שהמשתמש הגדיר לתווית הספציפית.

ייצוג ב-JSON 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
שדות
id

string

מזהה השדה
displayName

string

השם המוצג של השדה
type

string

סוג השדה
reason

object (Reason)

הסיבה להחלת השדה על התווית.
שדה איחוד value. הערכים שמאוחסנים בשדה value יכולים להיות רק אחד מהערכים הבאים:
unsetValue

boolean

אם השדה לא מוגדר, הערך יהיה true.
longTextValue

string

הגדרת ערך של טקסט ארוך.
textValue

string

הגדרת ערך טקסט.
textListValue

object (TextListValue)

הגדרת ערך של רשימת טקסט.
selectionValue

object (SelectionValue)

הגדרת ערך בחירה על ידי בחירת ערך יחיד מתוך תפריט נפתח.
selectionListValue

object (SelectionListValue)

הגדרת ערך של רשימת בחירה על ידי בחירת כמה ערכים מתוך תפריט נפתח.
integerValue

string (int64 format)

הגדרת ערך של מספר שלם.
userValue

object (UserValue)

הגדרת ערך משתמש על ידי בחירת משתמש יחיד.
userListValue

object (UserListValue)

הגדרת ערך של רשימת משתמשים על ידי בחירה של כמה משתמשים.
dateValue

object (Date)

הגדרת ערך תאריך.

TextListValue

הגדרת ערך של רשימת טקסט.

ייצוג ב-JSON 
{
  "values": [
    string
  ]
}
שדות
values[]

string

activities.list of text values.

SelectionValue

הגדרת ערך בחירה על ידי בחירת ערך יחיד מתוך תפריט נפתח.

ייצוג ב-JSON 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
שדות
id

string

המזהה של הבחירה.
displayName

string

השם המוצג של הבחירה.
badged

boolean

האם הבחירה מסומנת בתג.

SelectionListValue

הגדרת ערך של רשימת בחירה על ידי בחירת כמה ערכים מתוך תפריט נפתח.

ייצוג ב-JSON 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
שדות
values[]

object (SelectionValue)

activities.list of selections.

UserValue

הגדרת ערך משתמש על ידי בחירת משתמש יחיד.

ייצוג ב-JSON 
{
  "email": string
}
שדות
email

string

כתובת האימייל של המשתמש.

UserListValue

הגדרת ערך של רשימת משתמשים על ידי בחירה של כמה משתמשים.

ייצוג ב-JSON 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
שדות
values[]

object (UserValue)

activities.list of users.

תאריך

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

  • תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפסית (לדוגמה, יום נישואין).
  • שנה לבד, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

יום בחודש. הערך חייב להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי.

סיבה

הסיבה להחלת התווית או השדה.

ייצוג ב-JSON 
{
  "reasonType": string
}
שדות
reasonType

string

סוג הסיבה.