Method: accounts.searchChangeHistoryEvents

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

הפונקציה מחזירה רק את קבוצת המשנה של השינויים שה-API תומך בהם. יכול להיות שבממשק המשתמש יוצגו שינויים נוספים.

בקשת HTTP

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

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

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

פרמטרים
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)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
pageSize

integer

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

שימו לב: יכול להיות שהשירות יחזיר דף עם פחות פריטים מהערך שצוין (יכול להיות שאפילו אפס), ועדיין יכול להיות שיש דפים נוספים. אם רוצים מספר מסוים של פריטים, צריך להמשיך לבקש דפים נוספים באמצעות pageToken עד שמקבלים את המספר הרצוי.
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 resource
CONVERSION_EVENT המשאב ConversionEvent
MEASUREMENT_PROTOCOL_SECRET משאב MeasurementProtocolSecret
CUSTOM_DIMENSION משאב CustomDimension
CUSTOM_METRIC משאב CustomMetric
DATA_RETENTION_SETTINGS ‫DataRetentionSettings resource
DATA_STREAM משאב DataStream
ATTRIBUTION_SETTINGS משאב AttributionSettings
EXPANDED_DATA_SET משאב ExpandedDataSet
CHANNEL_GROUP משאב ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS משאב EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS ‫DataRedactionSettings resource
SKADNETWORK_CONVERSION_VALUE_SCHEMA ‫SKAdNetworkConversionValueSchema resource
AUDIENCE משאב קהל
EVENT_CREATE_RULE משאב EventCreateRule
KEY_EVENT משאב KeyEvent
CALCULATED_METRIC משאב CalculatedMetric
REPORTING_DATA_ANNOTATION משאב ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG משאב SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS משאב ReportingIdentitySettings

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)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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

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

ייצוג ב-JSON 
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
שדות

שדה איחוד resource.

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

object (Account)

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

object (Property)

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

object (GoogleSignalsSettings)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (CustomDimension)

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

object (CustomMetric)

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

object (DataRetentionSettings)

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

object (DataStream)

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

object (AttributionSettings)

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

object (ExpandedDataSet)

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

object (ChannelGroup)

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

object (EnhancedMeasurementSettings)

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

object (DataRedactionSettings)

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

object (SKAdNetworkConversionValueSchema)

תמונת מצב של מקור SKAdNetworkConversionValueSchema בהיסטוריית השינויים.
audience

object (Audience)

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

object (EventCreateRule)

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

object (KeyEvent)

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

object (CalculatedMetric)

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

object (ReportingDataAnnotation)

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

object (SubpropertySyncConfig)

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

object (ReportingIdentitySettings)

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