- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- רוצים לנסות?
חיפוש בכל השינויים שבוצעו בחשבון או בחשבונות הצאצא שלו בהתאם לקבוצת המסננים שצוינה.
בקשת HTTP
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
account |
חובה. משאב החשבון שעבורו יש להחזיר משאבים של היסטוריית שינויים. פורמט: accounts/{account} דוגמה: "accounts/100" |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "property": string, "resourceType": [ enum ( |
שדות | |
---|---|
property |
זה שינוי אופציונלי. שם המשאב של נכס צאצא. אם המדיניות מוגדרת, המערכת תחזיר רק את השינויים שבוצעו בנכס הזה או במשאבי הצאצא שלו. פורמט: properties/{propertyId} דוגמה: "properties/100" |
resourceType[] |
זה שינוי אופציונלי. אם היא מוגדרת, יש להחזיר שינויים רק אם הם מיועדים למשאב שתואם לפחות לאחד מהסוגים האלה. |
action[] |
זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים רק שינויים שתואמים לאחד או יותר מסוגי הפעולות האלה. |
actorEmail[] |
זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים שינויים רק אם הם בוצעו על ידי משתמש ברשימה הזו. |
earliestChangeTime |
זה שינוי אופציונלי. אם היא מוגדרת, יש להחזיר רק שינויים שבוצעו לאחר פרק הזמן הזה (כולל). חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
latestChangeTime |
זה שינוי אופציונלי. אם היא מוגדרת, יש להחזיר רק שינויים שבוצעו לפני המועד הזה (כולל). חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
pageSize |
זה שינוי אופציונלי. המספר המקסימלי של פריטי ChangeHistoryEvent שיש להחזיר. השירות עשוי להחזיר פחות מהערך הזה, גם אם יש דפים נוספים. אם לא צוין, יוחזרו 50 פריטים לכל היותר. הערך המקסימלי הוא 200 (ערכים גבוהים יותר יכפו לערך המקסימלי). |
pageToken |
זה שינוי אופציונלי. אסימון דף שהתקבל מקריאה קודמת של |
גוף התשובה
הודעת תגובה ל-RPC של חשבונות Search.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
שדות | |
---|---|
changeHistoryEvents[] |
תוצאות שהיו נגישות למתקשר. |
nextPageToken |
אסימון, שיכול להישלח בתור |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
סוגי משאבים שהשינויים שלהם עשויים להיות מוחזרים מהיסטוריית השינויים.
טיפוסים בני מנייה (enums) | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED |
סוג המשאב לא ידוע או לא צוין. |
ACCOUNT |
משאב החשבון |
PROPERTY |
משאב הנכס |
FIREBASE_LINK |
משאב FirebaseLink |
GOOGLE_ADS_LINK |
משאב GoogleAdsLink |
GOOGLE_SIGNALS_SETTINGS |
משאב GoogleSignalsSettings |
CONVERSION_EVENT |
משאב ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
משאב MeasurementProtocolSecret |
DATA_RETENTION_SETTINGS |
משאב DataRetentionSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
משאב DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
משאב DisplayVideo360AdvertiserLinkהצעה |
DATA_STREAM |
משאב DataStream |
ATTRIBUTION_SETTINGS |
מקור מידע של AttributionSettings |
ActionType
סוגי הפעולות שעשויות לשנות משאב.
טיפוסים בני מנייה (enums) | |
---|---|
ACTION_TYPE_UNSPECIFIED |
סוג הפעולה לא ידוע או לא צוין. |
CREATED |
המשאב נוצר בשינוי הזה. |
UPDATED |
המשאב עודכן בשינוי הזה. |
DELETED |
המשאב נמחק בשינוי הזה. |
ChangeHistoryEvent
קבוצת שינויים בחשבון Google Analytics או בנכסי הצאצא שלו, שנובעים מאותה סיבה. סיבות נפוצות הן עדכונים המבוצעים בממשק המשתמש של Google Analytics, שינויים מתמיכת הלקוחות או שינויים אוטומטיים במערכת של Google Analytics.
ייצוג JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
שדות | |
---|---|
id |
המזהה של אירוע היסטוריית השינויים הזה. המזהה הזה ייחודי בכל Google Analytics. |
changeTime |
השעה שבה בוצע השינוי. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorType |
סוג השחקן שביצע את השינוי. |
userActorEmail |
כתובת האימייל של חשבון Google שביצע את השינוי. זו תהיה כתובת אימייל חוקית אם שדה המשתמש מוגדר כ-USER, ואם לא, הוא ריק. חשבונות Google שנמחקו יגרמו לשגיאה. |
changesFiltered |
אם הערך הוא True, רשימת השינויים שהוחזרה סוננה ולא מייצגת את כל השינויים שהתרחשו באירוע הזה. |
changes[] |
רשימת שינויים שבוצעו באירוע היסטוריית השינויים הזה, ושמתאימים למסננים שצוינו ב-SearchChangeHistoryEventsRequest. |
ActorType
סוגי גורמים שונים שיכולים לבצע שינויים במשאבים של Google Analytics.
טיפוסים בני מנייה (enums) | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
סוג שחקן לא ידוע או לא מוגדר. |
USER |
שינויים שבוצעו על ידי המשתמש שצוין ב-actorEmail. |
SYSTEM |
שינויים שבוצעו על ידי מערכת Google Analytics. |
SUPPORT |
שינויים שבוצעו על ידי צוות התמיכה של Google Analytics. |
ChangeHistoryChange
תיאור של שינוי במשאב יחיד של Google Analytics.
ייצוג JSON |
---|
{ "resource": string, "action": enum ( |
שדות | |
---|---|
resource |
שם המשאב של המשאב שהשינויים שלו מתוארים על ידי הרשומה הזו. |
action |
סוג הפעולה ששינתה את המשאב הזה. |
resourceBeforeChange |
התוכן של המשאב מהתקופה שלפני ביצוע השינוי. אם המשאב הזה נוצר בשינוי הזה, השדה הזה יהיה חסר. |
resourceAfterChange |
התוכן של מקורות המידע אחרי ביצוע השינוי. אם המשאב נמחק במסגרת השינוי, השדה הזה יהיה חסר. |
ChangeHistoryResource
תמונת מצב של משאב לפני או אחרי השינוי בהיסטוריית השינויים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
|
|
account |
תמונת מצב של משאב בחשבון בהיסטוריית השינויים. |
property |
תמונת מצב של משאב נכס בהיסטוריית השינויים. |
firebaseLink |
תמונת מצב של משאב FirebaseLink בהיסטוריית השינויים. |
googleAdsLink |
תמונת מצב של משאב Google AdsLink בהיסטוריית השינויים. |
conversionEvent |
תמונת מצב של משאב ConversionEvent בהיסטוריית השינויים. |
measurementProtocolSecret |
תמונת מצב של משאב MeasurementProtocolSecret בהיסטוריית השינויים. |
dataRetentionSettings |
תמונת מצב של משאב הגדרות שמירת נתונים בהיסטוריית השינויים. |
dataStream |
תמונת מצב של משאב DataStream בהיסטוריית השינויים. |