- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- רוצים לנסות?
חיפוש בכל השינויים בחשבון או הצאצאים שלו בהתאם לקבוצת המסננים שצוינה.
בקשת HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
account |
חובה. משאב החשבון שעבורו מוחזרים משאבים של היסטוריית שינויים. פורמט: accounts/{account} דוגמה: |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "property": string, "resourceType": [ enum ( |
שדות | |
---|---|
property |
זה שינוי אופציונלי. שם המשאב של נכס צאצא. אם המדיניות מוגדרת, יוחזרו רק שינויים שבוצעו בנכס הזה או במשאבים הצאצאים שלו. פורמט: properties/{propertyId} דוגמה: |
resourceType[] |
זה שינוי אופציונלי. אם המדיניות מוגדרת, המערכת תחזיר שינויים רק אם הם קיימים במשאב שתואם לפחות לאחד מהסוגים האלה. |
action[] |
זה שינוי אופציונלי. אם המדיניות מוגדרת, המערכת תחזיר רק שינויים שתואמים לאחד או יותר מסוגי הפעולות האלה. |
actorEmail[] |
זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים שינויים רק אם הם בוצעו על ידי משתמש ברשימה הזו. |
earliestChangeTime |
זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים רק שינויים שבוצעו אחרי פרק הזמן הזה (כולל). חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
latestChangeTime |
זה שינוי אופציונלי. אם המדיניות מוגדרת, מוחזרים רק שינויים שבוצעו לפני המועד הזה (כולל). חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
pageSize |
זה שינוי אופציונלי. המספר המקסימלי של פריטים ב-ChangeHistoryEvent שצריך להחזיר. השירות עשוי להחזיר פחות מהערך הזה, גם אם יש דפים נוספים. אם לא מגדירים, יוחזרו 50 פריטים לכל היותר. הערך המקסימלי הוא 200 (ערכים גבוהים יותר ייקראו לערך המקסימלי). |
pageToken |
זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב- |
גוף התשובה
הודעת תגובה ל-RPC בחשבונות SearchAccounts.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
שדות | |
---|---|
changeHistoryEvents[] |
תוצאות שהיו נגישות למתקשר. |
nextPageToken |
אסימון, שניתן לשלוח בתור |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
סוגי משאבים שהשינויים שלהם עשויים להיות מוחזרים מהיסטוריית השינויים.
טיפוסים בני מנייה (enum) | |
---|---|
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 |
CUSTOM_DIMENSION |
משאב של מאפיין מותאם אישית |
CUSTOM_METRIC |
משאב CustomMetric |
DATA_RETENTION_SETTINGS |
משאב DataRetentionSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
משאב DisplayVideo360 AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
משאב DisplayVideo360 AdvertiserLinkהצעה |
SEARCH_ADS_360_LINK |
מקור מידע בנושא SearchAds360Link |
DATA_STREAM |
משאב DataStream |
ATTRIBUTION_SETTINGS |
מקור המידע בנושא AttributionSettings |
EXPANDED_DATA_SET |
משאב מורחב |
CHANNEL_GROUP |
משאב ChannelGroup |
BIGQUERY_LINK |
קישור למקור מידע ב-BigQuery |
ENHANCED_MEASUREMENT_SETTINGS |
מקור מידע של EnhancedMeasurementSettings |
DATA_REDACTION_SETTINGS |
משאב DataRedactionSettings |
SKADNETWORK_CONVERSION_VALUE_SCHEMA |
משאב SKAdNetworkConversionValueSchema |
ADSENSE_LINK |
מקור מידע של AdSenseLink |
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 ( |
שדות | |
---|---|
id |
המזהה של אירוע היסטוריית השינויים הזה. המזהה הזה ייחודי ב-Google Analytics. |
changeTime |
השעה שבה בוצע השינוי. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
actorType |
סוג הגורם שביצע את השינוי. |
userActorEmail |
כתובת האימייל של חשבון Google שביצע את השינוי. אם השדה 'שחקן' מוגדר כ-USER, כתובת האימייל הזו תהיה ריקה. אחרת, השדה הזה יהיה ריק. חשבונות Google שנמחקו יגרמו לשגיאה. |
changesFiltered |
אם הערך הוא True, רשימת השינויים שהוחזרו מסוננת והיא לא מייצגת את כל השינויים שהתרחשו באירוע הזה. |
changes[] |
רשימה של שינויים שבוצעו באירוע הזה של היסטוריית השינויים, שתואמים למסננים שצוינו ב-SearchChangeHistoryEventsRequest. |
ActorType
סוגים שונים של גורמים שיכולים לבצע שינויים במשאבים של Google Analytics.
טיפוסים בני מנייה (enum) | |
---|---|
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 |
תמונת מצב של משאב GoogleAdsLink בהיסטוריית השינויים. |
googleSignalsSettings |
תמונת מצב של משאב GoogleSignalsSettings בהיסטוריית השינויים. |
displayVideo360AdvertiserLink |
תמונת מצב של משאב DisplayVideo360 AdvertiserLink בהיסטוריית השינויים. |
displayVideo360AdvertiserLinkProposal |
תמונת מצב של משאב DisplayVideo360 AdvertiserLinkהצעה בהיסטוריית השינויים. |
conversionEvent |
תמונת מצב של משאב ConversionEvent בהיסטוריית השינויים. |
measurementProtocolSecret |
תמונת מצב של משאב MeasurementProtocolSecret בהיסטוריית השינויים. |
customDimension |
תמונת מצב של משאב של מאפיין מותאם אישית בהיסטוריית השינויים. |
customMetric |
תמונת מצב של משאב CustomMetric בהיסטוריית השינויים. |
dataRetentionSettings |
תמונת מצב של משאב ההגדרות של שמירת נתונים בהיסטוריית השינויים. |
searchAds360Link |
תמונת מצב של משאב Search Ads360Link בהיסטוריית השינויים. |
dataStream |
תמונת מצב של משאב DataStream בהיסטוריית השינויים. |
attributionSettings |
תמונת מצב של המשאב AttributionSettings בהיסטוריית השינויים. |
expandedDataSet |
תמונת מצב של משאבExpandedDataSet בהיסטוריית השינויים. |
channelGroup |
תמונת מצב של משאב ChannelGroup בהיסטוריית השינויים. |
bigqueryLink |
תמונת מצב של משאב קישור ל-BigQuery בהיסטוריית השינויים. |
enhancedMeasurementSettings |
תמונת מצב של משאב EnhancedMeasurementSettings בהיסטוריית השינויים. |
dataRedactionSettings |
תמונת מצב של המשאב DataRedactionSettings בהיסטוריית השינויים. |
skadnetworkConversionValueSchema |
תמונת מצב של המשאב SKAdNetworkConversionValueSchema בהיסטוריית השינויים. |
adsenseLink |
תמונת מצב של משאב AdSenseLink בהיסטוריית השינויים. |
audience |
תמונת מצב של משאב הקהלים בהיסטוריית השינויים. |
eventCreateRule |
תמונת מצב של משאב EventCreateRule בהיסטוריית השינויים. |
calculatedMetric |
תמונת מצב של משאב ממוספר בהיסטוריית השינויים |