Method: accounts.searchChangeHistoryEvents

ค้นหาการเปลี่ยนแปลงทั้งหมดในบัญชีหรือบัญชีย่อยตามชุดตัวกรองที่ระบุ

แสดงเฉพาะชุดย่อยของการเปลี่ยนแปลงที่ API รองรับ UI อาจแสดงการเปลี่ยนแปลงเพิ่มเติม

คำขอ 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)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงสำหรับทรัพยากรที่ตรงกับประเภทเหล่านี้อย่างน้อย 1 ประเภท
action[]

enum (ActionType)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่ตรงกับการกระทำประเภทเหล่านี้อย่างน้อย 1 ประเภท
actorEmail[]

string

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่ผู้ใช้ในรายการนี้ทํา
earliestChangeTime

string (Timestamp format)

ไม่บังคับ หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่เกิดขึ้นหลังจากเวลานี้ (รวมเวลานี้ด้วย)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ

เนื้อหาการตอบกลับ

ข้อความตอบกลับสําหรับ SearchAccounts RPC

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง 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 ทรัพยากร CustomDimension
CUSTOM_METRIC ทรัพยากร CustomMetric
DATA_RETENTION_SETTINGS ทรัพยากร DataRetentionSettings
DATA_STREAM ทรัพยากร DataStream
ATTRIBUTION_SETTINGS ทรัพยากร AttributionSettings
EXPANDED_DATA_SET ทรัพยากร ExpandedDataSet
CHANNEL_GROUP ทรัพยากร ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS ทรัพยากร EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS ทรัพยากร DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA ทรัพยากร SKAdNetworkConversionValueSchema
AUDIENCE ทรัพยากรกลุ่มเป้าหมาย
EVENT_CREATE_RULE ทรัพยากร EventCreateRule
CALCULATED_METRIC ทรัพยากร CalculatedMetric

ActionType

ประเภทการดําเนินการที่อาจเปลี่ยนแปลงทรัพยากร

Enum
ACTION_TYPE_UNSPECIFIED ไม่ทราบประเภทการดำเนินการหรือไม่ระบุ
CREATED มีการสร้างทรัพยากรในการเปลี่ยนแปลงนี้
UPDATED ทรัพยากรได้รับการอัปเดตในการเปลี่ยนแปลงนี้
DELETED มีการเปลี่ยนแปลงที่ลบทรัพยากร

ChangeHistoryEvent

ชุดการเปลี่ยนแปลงภายในบัญชี Google Analytics หรือพร็อพเพอร์ตี้ย่อยที่เกิดจากสาเหตุเดียวกัน สาเหตุที่พบบ่อย ได้แก่ การอัปเดตใน UI ของ 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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 ที่ทำการเปลี่ยนแปลง อีเมลนี้ต้องเป็นอีเมลที่ถูกต้องหากตั้งค่าช่องผู้ดําเนินการเป็น USER และจะเป็นค่าว่างหากเป็นอย่างอื่น บัญชี Google ที่ลบไปแล้วจะทำให้เกิดข้อผิดพลาด
changesFiltered

boolean

หากเป็น "จริง" แสดงว่าระบบกรองรายการการเปลี่ยนแปลงที่แสดงผลแล้ว และรายการดังกล่าวไม่ได้แสดงการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นในเหตุการณ์นี้
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)

ภาพรวมของทรัพยากร 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)

ภาพรวมของทรัพยากร CalculatedMetric ในประวัติการเปลี่ยนแปลง