Method: accounts.searchChangeHistoryEvents

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

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

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

string (Timestamp format)

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

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

integer

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

string

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

גוף התשובה

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

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

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

object (ChangeHistoryEvent)

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

string

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

היקפי הרשאה

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

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

ChangeHistoryResourceType

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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)

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

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

enum (ActorType)

סוג הגורם שביצע את השינוי.
userActorEmail

string

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

boolean

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

object (ChangeHistoryChange)

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

ActorType

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

טיפוסים בני מנייה (enum)
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

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

ייצוג 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)

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

object (Property)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (DataRetentionSettings)

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

object (DataStream)

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