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

ไม่บังคับ ชื่อทรัพยากรสำหรับพร็อพเพอร์ตี้ย่อย หากตั้งค่าไว้ ระบบจะแสดงเฉพาะการเปลี่ยนแปลงที่เกิดขึ้นกับพร็อพเพอร์ตี้นี้หรือทรัพยากรย่อยของพร็อพเพอร์ตี้นี้เท่านั้น รูปแบบ: พร็อพเพอร์ตี้/{propertyId}

เช่น properties/100
resourceType[]

enum (ChangeHistoryResourceType)

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

enum (ActionType)

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

string

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

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
latestChangeTime

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
pageSize

integer

ไม่บังคับ จำนวนรายการ ChangeHistoryEvent สูงสุดที่จะแสดง บริการอาจแสดงน้อยกว่าค่านี้ แม้ว่าจะมีหน้าเพิ่มเติมก็ตาม หากไม่ระบุ ระบบจะส่งคืนสินค้าไม่เกิน 50 รายการ ค่าสูงสุดคือ 200 (ค่าที่สูงกว่าจะถูกเปลี่ยนเป็นค่าสูงสุด)
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 ทรัพยากร Dataกฎการเก็บรักษา
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 ทรัพยากรที่คำนวณแล้ว

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)

เวลาที่ทำการเปลี่ยนแปลง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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)

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

object (Audience)

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

object (EventCreateRule)

สแนปชอตของทรัพยากร EventCreateRule ในประวัติการเปลี่ยนแปลง
calculatedMetric

object (CalculatedMetric)

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