Method: accounts.searchChangeHistoryEvents

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

בקשת HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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
CUSTOM_DIMENSION משאב של מאפיין מותאם אישית
CUSTOM_METRIC משאב CustomMetric
DATA_RETENTION_SETTINGS משאב DataRetentionSettings
DATA_STREAM משאב DataStream
ATTRIBUTION_SETTINGS מקור המידע בנושא AttributionSettings
EXPANDED_DATA_SET משאב מורחב
CHANNEL_GROUP משאב ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS מקור מידע של EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS משאב DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA משאב SKAdNetworkConversionValueSchema
AUDIENCE משאב קהל
EVENT_CREATE_RULE משאב EventCreateRule
CALCULATED_METRIC משאב ComputedMetric

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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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.

טיפוסים בני מנייה (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)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // End of list of possible types for union field resource.
}
שדות

שדה איחוד resource.

resource יכול להיות רק אחת מהאפשרויות הבאות:
account

object (Account)

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

object (Property)

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

object (GoogleSignalsSettings)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (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 בהיסטוריית השינויים.
calculatedMetric

object (CalculatedMetric)

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