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)

ไม่บังคับ หากตั้งค่าไว้ ให้แสดงเฉพาะการเปลี่ยนแปลงที่ตรงกับการกระทำประเภทใดประเภทหนึ่งต่อไปนี้
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 (ค่าที่สูงกว่าจะถูกบังคับให้เป็นค่าสูงสุด)

โปรดทราบว่าบริการอาจแสดงผลหน้าเว็บที่มีจำนวนรายการน้อยกว่าค่าที่ระบุ (อาจเป็น 0 ด้วย) และอาจยังมีหน้าเว็บเพิ่มเติม หากต้องการรายการในจำนวนที่เฉพาะเจาะจง คุณจะต้องขอหน้าเว็บเพิ่มเติมต่อไปโดยใช้ 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
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
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 หรือพร็อพเพอร์ตี้ย่อยที่เกิดจากสาเหตุเดียวกัน สาเหตุที่พบบ่อยคือการอัปเดตที่ทําใน 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 เสมอ และใช้ตัวเลขเศษส่วน 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)
  },
  "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.
}
ช่อง

ฟิลด์ Union 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 ในประวัติการเปลี่ยนแปลง
keyEvent

object (KeyEvent)

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

object (CalculatedMetric)

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

object (ReportingDataAnnotation)

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

object (SubpropertySyncConfig)

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

object (ReportingIdentitySettings)

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