Method: accounts.searchChangeHistoryEvents

חיפוש בכל השינויים שבוצעו בחשבון או בחשבונות הצאצא שלו בהתאם לקבוצת המסננים שצוינה.

בקשת HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
account

string

חובה. משאב החשבון שעבורו יש להחזיר משאבים של היסטוריית שינויים. פורמט: accounts/{account} דוגמה: "accounts/100"

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
שדות
property

string

זה שינוי אופציונלי. שם המשאב של נכס צאצא. אם המדיניות מוגדרת, המערכת תחזיר רק את השינויים שבוצעו בנכס הזה או במשאבי הצאצא שלו. פורמט: properties/{propertyId} דוגמה: "properties/100"
resourceType[]

enum (ChangeHistoryResourceType)

זה שינוי אופציונלי. אם היא מוגדרת, יש להחזיר שינויים רק אם הם מיועדים למשאב שתואם לפחות לאחד מהסוגים האלה.
action[]

enum (ActionType)

זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים רק שינויים שתואמים לאחד או יותר מסוגי הפעולות האלה.
actorEmail[]

string

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

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של פריטי ChangeHistoryEvent שיש להחזיר. השירות עשוי להחזיר פחות מהערך הזה, גם אם יש דפים נוספים. אם לא צוין, יוחזרו 50 פריטים לכל היותר. הערך המקסימלי הוא 200 (ערכים גבוהים יותר יכפו לערך המקסימלי).
pageToken

string

זה שינוי אופציונלי. אסימון דף שהתקבל מקריאה קודמת של accounts.searchChangeHistoryEvents. ספקו אותו כדי לאחזר את הדף הבא. במהלך העימוד, כל הפרמטרים האחרים שצוינו ל-accounts.searchChangeHistoryEvents חייבים להתאים לקריאה שסיפקה את אסימון הדף.

גוף התשובה

הודעת תגובה ל-RPC של חשבונות Search.

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

ייצוג JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
שדות
changeHistoryEvents[]

object (ChangeHistoryEvent)

תוצאות שהיו נגישות למתקשר.
nextPageToken

string

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

היקפי הרשאות

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

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

סוגי משאבים שהשינויים שלהם עשויים להיות מוחזרים מהיסטוריית השינויים.

טיפוסים בני מנייה (enums)
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED סוג המשאב לא ידוע או לא צוין.
ACCOUNT משאב החשבון
PROPERTY משאב הנכס
GOOGLE_SIGNALS_SETTINGS משאב GoogleSignalsSettings
CONVERSION_EVENT משאב ConversionEvent
MEASUREMENT_PROTOCOL_SECRET משאב MeasurementProtocolSecret
DATA_RETENTION_SETTINGS משאב DataRetentionSettings
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 (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
שדות
id

string

המזהה של אירוע היסטוריית השינויים הזה. המזהה הזה ייחודי בכל Google Analytics.
changeTime

string (Timestamp format)

השעה שבה בוצע השינוי.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

סוג השחקן שביצע את השינוי.
userActorEmail

string

כתובת האימייל של חשבון Google שביצע את השינוי. זו תהיה כתובת אימייל חוקית אם שדה המשתמש מוגדר כ-USER, ואם לא, הוא ריק. חשבונות Google שנמחקו יגרמו לשגיאה.
changesFiltered

boolean

אם הערך הוא True, רשימת השינויים שהוחזרה סוננה ולא מייצגת את כל השינויים שהתרחשו באירוע הזה.
changes[]

object (ChangeHistoryChange)

רשימת שינויים שבוצעו באירוע היסטוריית השינויים הזה, ושמתאימים למסננים שצוינו ב-SearchChangeHistoryEventsRequest.

ActorType

סוגי גורמים שונים שיכולים לבצע שינויים במשאבים של Google Analytics.

טיפוסים בני מנייה (enums)
ACTOR_TYPE_UNSPECIFIED סוג שחקן לא ידוע או לא מוגדר.
USER שינויים שבוצעו על ידי המשתמש שצוין ב-actorEmail.
SYSTEM שינויים שבוצעו על ידי מערכת Google Analytics.
SUPPORT שינויים שבוצעו על ידי צוות התמיכה של Google Analytics.

ChangeHistoryChange

תיאור של שינוי במשאב יחיד של Google Analytics.

ייצוג JSON 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
שדות
resource

string

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

enum (ActionType)

סוג הפעולה ששינתה את המשאב הזה.
resourceBeforeChange

object (ChangeHistoryResource)

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

object (ChangeHistoryResource)

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

ChangeHistoryResource

תמונת מצב של משאב לפני או אחרי השינוי בהיסטוריית השינויים.

ייצוג JSON 
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
שדות

שדה איחוד resource.

resource יכול להיות רק אחד מהבאים:
account

object (Account)

תמונת מצב של משאב בחשבון בהיסטוריית השינויים.
property

object (Property)

תמונת מצב של משאב נכס בהיסטוריית השינויים.
conversionEvent

object (ConversionEvent)

תמונת מצב של משאב ConversionEvent בהיסטוריית השינויים.
measurementProtocolSecret

object (MeasurementProtocolSecret)

תמונת מצב של משאב MeasurementProtocolSecret בהיסטוריית השינויים.
dataRetentionSettings

object (DataRetentionSettings)

תמונת מצב של משאב הגדרות שמירת נתונים בהיסטוריית השינויים.
dataStream

object (DataStream)

תמונת מצב של משאב DataStream בהיסטוריית השינויים.